Reorganize doc guidelines into multiple pages; update style guide

The existing doc guidelines page attempts to combine too many different
topics at once and includes information that does not pertain directly
to the documentation. This reorganization is intended to make each type
of information easier to find. For example, some have found it difficult
to find the documentation style guidelines (see, e.g.,
QubesOS/qubes-issues#6701#issuecomment-875875610). This reorganization
allows us to assign more specific titles to each page.

General changes:
- Create new page for contribution instructions
- Create new page for website style guide
- Create new page for continuous integration
- Rename existing "style guide" to "visual style guide" in order to
  avoid ambiguity with new doc and website style guides
- Retain existing page solely for doc style guide
- Update page names and permalinks
- Update existing links
- Improve language

Doc style guide changes:
- Add section on using sentence case in headings
  (see QubesOS/qubes-issues#6756 and #1173)
- Improve section organization
- Clarify language

In order to better preserve the Git history of each file, file renames
will be handled in a separate commit.
This commit is contained in:
Andrew David Wong 2021-07-08 07:41:19 -07:00
parent c4f59952f5
commit c29cf40910
No known key found for this signature in database
GPG key ID: 8CE137352A019A17
15 changed files with 481 additions and 411 deletions

View file

@ -34,7 +34,7 @@ templates, along with some examples of common use cases.
bug report. Instead, please see [Help, Support, Mailing Lists, and
Forum](/support/) for the appropriate place to ask for help. Once you have
learned how to solve your problem, please [contribute what you learned to
the documentation](/doc/doc-guidelines/).
the documentation](/doc/how-to-edit-the-documentation/).
3. The minimal templates are intentionally *minimal*. [Do not ask for your
favorite package to be added to the minimal template by