kp2pml30's personal blogHOMEROFSABOUTLNK

Text Style

Titles

Titles must be in Title Case

Text

  1. Prefer source lines no longer than 128 columns, so that source is readable as well
  2. For unlinked terms and variables, such as iff prefer italics
  3. Trailing dot seems rude, so neither paragraphs nor list items should end with it
  4. Start sentences with a Capital letter

Lists

  1. List items should start with capital letters, though if it is a sub-list or less important information it can start with lower letters. Nevertheless, all items in a given list must be the same

  2. And again, no trailing periods
  3. Prefer to use numbered lists, as they are easier to grasp and reference. However, if you wish to avoid specifying explicit order, use unnumbered lists. For example:

    I like

    • Berries
    • Fruits

    Reads clearly as the writer loves both, while numbered alternative would seem like the author prefers berries over fruits

Ease of Reading

Try to number slides and pages, for ease of referencing them