New Riders Style Conventions

  Object names, file names, folder names, directory names, GUI related terms, etc.
  are done without emphasis, just plain font. First letter can be upper case as
  appropriate.

  Variable names and first instance of a concept are italicized.

  Code, code fragments, commands/programs run from the command line, 
  URLs, are in fixed width font.

  Quotes are used around chapter and section names, and for quotations, not for
  what the user types, that should just be plain font.

Zope Book Style Conventions

  Zope object type names -- For example, Folder, DTML Method, etc. Italic

    Examples:

      To do this, add a *DTML Document* to the 'foo' folder.

    When used informally this should be plain font, no italics; notice how
    the last instance of folder is not emphasized

  Variable names -- DTML and python variables and names of instances. These
    should be fixed width.

  Code, code fragments -- DTML, Python, HTML and other code, or code
    fragments should be fixed width.

  GUI related terms -- When first introduced, italic.  Subsequently regular
    body text initial cap (that means first letter capitalized).

    Examples:

      First Usage:

        Any action in Zope that causes objects to change can be undone,
        via the *Undo* view.

      Subsequent usage:

        Undo this action by clicking on the Undo tab.

  Form label names -- Such as "type your name into the *Name* field".
  Should be Italic.

  DTML Tags -- Tag name italics.  "The *var* tag is used to insert a
  variable".

  URLS -- Italic. 

  Technical terms (for emphasis) -- Italic. 

  File names (.exe file; doc/INSTALL.txt) -- Italic 

  Directory names (Zope directory) -- Italic. 

  Program names (Unwise.exe) -- Italic. 

  Script names (zpasswd.py) -- Italic. 

  User names or user ID's (nobody; root) -- Italic. 

  Icon names (start.bat) -- should also be italic. This one is a grey area
    because it's also a GUI term (see above for GUI terms), but I'd go with
    italic when in doubt.

  Machine names -- Italic. 

  "Double Quoting" -- The only instance of quotes should be when you are
    writing what the user types in, and it doesn't appear on its own line.
    If its on its own line it's literal, if it's within regular body text
    it's quoted (ex. In the *Name* field, type "Michel").  In the midst of
    prose, use quotes, otherwise, use literal.


