==== 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