meta data for this page
  •  

Style Guide

Headings

  • Headings and page names should use title capitalization
  • Heading levels should start at the first level. This probably sounds stupid, but on the old site, you had to start at level 2 (level 1 was for page title), and some of that carried over.
  • Headings should not be used for recommendations
  • After a heading, do not include a blank line

Recommendations

  • Do not use a heading for a recommendation
  • Use normal style, but add both bold and italics
  • Use sentence (not title) capitalization
  • When an entire page (and therefore its title) is a single recommendation, rename the page to be more of a heading and less of a recommendation
  • Put the recommendation on it's own line
  • If at all possible, state as a directive with a verb
  • Avoid pronouns so that the recommendation stands on its own away from the discussion
  • Make it as short and sweet as possible, keeping elaboration for the discussion
  • Do not include a period at the end
  • Do not put a blank line between the recommendation and the ensuing discussion
  • It is OK to have two lines with two recommendations right after each other, followed by joint discussion/explanation
  • See Voice Talent for examples

Lists

  • Lists should be presented as bullets
  • See TTS for an example (under Avoid using TTS to refer to callers by name)

Examples

  • Examples should be indented, in Italic font, and begin with System: or Caller:
  • A blank line should follow the example
    • System: To confirm, you want to transfer $500 from savings to checking.
    • Caller: Yes
  • You can omit the “System” or “Caller” if there's only one type being used.

References

  • References should appear at the bottom of the page, sorted alphabetically by the first author's last name