You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
manual/StyleGuide.rst

48 lines
1.3 KiB

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)
- Capitalize the start of files and the titles.
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
Releasing
---------
Release day get final sha256 hash to add to chapter 1.1 downloading the image with final hash. The beta/daily isos will have a different hash so this needs to be done release day.
Check that there are no warning with make clean && make html
Merge master into stable.
fix any merge conflicts
if LTS merge master onto lts
fix merge conflicts
done