Commit Graph

9 Commits

Author SHA1 Message Date
Andrew David Wong
c29cf40910
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.
2021-07-08 08:08:57 -07:00
Andrew David Wong
71a3f2bdbe
Update heading syntax; wrap text 2021-06-19 20:26:51 -07:00
Tobias Killer
9415119edc
Refactor links in order to obey the new convention rule 2021-04-11 01:00:19 +02:00
Axon
e536e6c1de
Fix typo 2016-03-22 22:52:54 +00:00
Axon
dd3d64c956
Update README
Remove information about contributing and instead refer readers to the
Documentation Guidelines. This will help to avoid future desynchronization
issues.
2016-03-22 22:38:54 +00:00
Axon
49c5e763b9
Update README 2015-11-08 01:05:45 +00:00
Axon
fc385586b6
Remove en/ from URLs (QubesOS/qubes-issues#1333) 2015-10-28 22:14:40 +00:00
Axon
2d7f823a53
Activate URL 2015-09-22 10:36:44 +00:00
Axon
5f040b3a06
Create README 2015-09-22 10:31:00 +00:00