Skip to content

Latest commit

 

History

History
14 lines (12 loc) · 1.08 KB

editing-guidelines.md

File metadata and controls

14 lines (12 loc) · 1.08 KB

Editing Guidelines

"Mastering Zotero" is written with the following guidelines kept in mind:

  • use the Oxford comma. E.g. "one, two, and three".
  • use US English spelling, but place punctuation outside quotation marks.
  • we prefer a personal style. Write "you" instead of "the user", and use active voice wherever possible.
  • mark up Zotero for Firefox and Zotero Standalone in bold. Do not abbreviate.
  • try to limit the number of header levels to three (#, ##, ###)
  • mark up interface elements (tab labels, menus) in bold, e.g. "the File menu".
  • mark up shortcuts as code, e.g. Shift + Enter.
  • mark up menu entries and button labels in double quotes, e.g. "press the 'Search' button"
  • include the icon for buttons after the text description, and in parentheses, e.g. "the Actions menu (…Actions menu icon…)"
  • screenshot file names should indicate the operating system, the software pictured, the Zotero version, and the topic (e.g. "OSX-ZS-4-0-8-tag-field.png" for a screenshot on OS X, about the tag field in Zotero Standalone 4.0.8)