Difference between revisions of "AuthorsGuide"

From Earth Science Information Partners (ESIP)
Line 1: Line 1:
 
== General guidance ==
 
== General guidance ==
  
* Please use the [[Media:DataShortCourseModuleTemplate.ppt template]]
+
* Please use the [[Media:DataShortCourseModuleTemplate.ppt | template]]
 
* Please use sentence case for all titles on every page
 
* Please use sentence case for all titles on every page
 
* As long as all the information mentioned in the template is covered, please feel free to add, subtract or combine body pages of the module as needed; however, keep the References and Resources slide and Other Relevant Modules slides separate so that those materials can be aggregated together when a person uses multiple modules within a single presentation
 
* As long as all the information mentioned in the template is covered, please feel free to add, subtract or combine body pages of the module as needed; however, keep the References and Resources slide and Other Relevant Modules slides separate so that those materials can be aggregated together when a person uses multiple modules within a single presentation

Revision as of 16:46, September 14, 2011

General guidance

  • Please use the template
  • Please use sentence case for all titles on every page
  • As long as all the information mentioned in the template is covered, please feel free to add, subtract or combine body pages of the module as needed; however, keep the References and Resources slide and Other Relevant Modules slides separate so that those materials can be aggregated together when a person uses multiple modules within a single presentation
  • If your module runs to 10 slides or more, please contact Ruth and split the module into smaller pieces
  • When developing a module please ensure that the contents reflect the ESIP membership. It isn't necessary to cover fields, agencies, etc. that are outside the ESIP family. If a module is specific to a particular group (discipline or agency) the module title needs to reflect that!
  • Modules will typically run 5-10 pages in length; but in particular section header modules may be very short
  • Module title/subtitle should be in the upper left corner of every page (in small print)

Module cover page

  • Please put the name of the module in the "Subtitle" field
  • Please put the section header for the module in the "Module Template" field
    • For example, the section header for the NSF data management plan module is Agency requirements
    • For example, the section header for Agency requirements module is "The case for data stewardship"
  • Author names and organizations
    • Use Firstname Lastname format for each name (e.g., Joe Smith)
    • Separate first/last name pairs by commas (e.g., Joe Smith, John Doe)
    • If there are multiple organizations indicate that using superscripts
      • For example
        • Joe Smith 1, John Doe 2
        • 1 OrganizationA
        • 2 OrganizationB