|
|
|
|
Style Guide
|
|
|
|
|
===========
|
|
|
|
|
|
|
|
|
|
- Program names use the same capitalization you use in the main menu.
|
|
|
|
|
|
|
|
|
|
- Use code directives for input into the command line.
|
|
|
|
|
|
|
|
|
|
- Use :guilabel:`Button` for buttons and checkboxes.
|
|
|
|
|
|
|
|
|
|
- Use :kbd:`Shortcut` for keyboard shortcuts and buttons you press.
|
|
|
|
|
|
|
|
|
|
- Use :menuselection:`Item --> Subitem` for things in menus and context menus.
|
|
|
|
|
|
|
|
|
|
- Use the - for bullet pointed lists usually at the beginning of lists of features.
|
|
|
|
|
|
|
|
|
|
- Use oxford commas for easier adding or removing features.
|
|
|
|
|
|
|
|
|
|
- Use .. Warning:: if doing something wrong can cause data loss or machine not to boot.
|
|
|
|
|
|
|
|
|
|
- Order sections Summary --> Usage --> Screenshot (if one or two) --> Version --> How To Launch --> Customizing (If necessary)
|
|
|
|
|
|
|
|
|
|
Sections
|
|
|
|
|
--------
|
|
|
|
|
|
|
|
|
|
- Start each program or section being underlines with =
|
|
|
|
|
|
|
|
|
|
- Have - put under them for a section about a program.
|
|
|
|
|
|
|
|
|
|
- Keep screenshots near the text that describes them
|
