Commit Graph

26 Commits

Author SHA1 Message Date
Andrew David Wong
717810fb11
Document 'zenity' requirement for GUI inter-qube copying
Fixes QubesOS/qubes-issues#6801
2021-07-28 22:53:15 -07:00
Andrew David Wong
ca0ccab949
Update titles and links 2021-07-10 14:25:29 -07:00
Andrew David Wong
a18174dc5e
Fix capitalization; update terms (QubesOS/qubes-issues#6769)
Thank you to @unman for the initial sentence case pass.
2021-07-09 05:10:44 -07:00
unman
d0bc9e70a2
Sentence case for titles 2021-07-09 01:06:41 +00:00
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
0b5e3005c2
Document template testing; improve related docs
- Document template testing repos
- Introduce dom0 testing repos
- Cross-link dom0 and domU testing repo sections
- Link to template testing section from related sections
- Add pointer to installing templates
- Minor improvements and fixes

Thanks to @GWeck for pointing out the need for this in:
https://forum.qubes-os.org/t/fedora-34-template-available-for-testing/4904/4
2021-07-05 06:09:42 -07:00
Andrew David Wong
5220089b53
Update references to "Getting Started"
QubesOS/qubes-issues#6756
2021-07-03 03:46:27 -07:00
Marek Marczykowski-Górecki
1d40a958c2
Sort frontmatter entries
Again, this makes scripted modifications easier.
2021-06-24 16:10:26 +02:00
Marek Marczykowski-Górecki
3806ecf338
Remove extra newlines at the beginning/end of files
Those are redundant, and yaml parser strips them in fact. By removing
them, loading and saving yaml file without any change indeed produce the
same output. This is useful for prepare_for_translation.py script (which
adds lang and ref tags) - to produce only change that indeed was made.
2021-06-24 16:07:23 +02:00
Andrew David Wong
7c83d84381
Fix link; add section on installing software 2021-06-20 22:01:01 -07:00
Andrew David Wong
3b0c0be9be
Steer newbies toward easy upgrade method even more 2021-06-20 21:55:36 -07:00
Andrew David Wong
dffa3502fd
Update "Templates"
- Add links
- Improve formatting
- Improve command examples
- Add related information
- Improve language
- Improve inheritance and persistence table
- Update terminology
- Wrap text
2021-06-20 20:03:48 -07:00
Andrew David Wong
a2511357a7
Mark pages as advanced 2021-06-19 02:36:05 -07:00
Andrew David Wong
7e3bc9511f
Update "Minimal Templates"
- Mark as advanced page
- Revise introduction
- Move list of available templates to new section
- Clarify installation commands
- Fix language and syntax errors
- Wrap text
2021-06-19 02:15:40 -07:00
deeplow
b9b49c4d2b
Mention why one would use minimal templates
Content credit: SvenSemmler https://qubes-os.discourse.group/t/debian-10-minimal-configuration/2603/54
2021-06-19 08:05:57 +00:00
Andrew David Wong
50270f435c
Fix links 2021-06-18 03:09:09 -07:00
Andrew David Wong
2ae0ce9524
Mass replace "StandaloneVM" with "standalone"
Also updates the "Standalones and HVM" page.

QubesOS/qubes-issues#1015
2021-06-18 02:29:28 -07:00
Andrew David Wong
63498a6c17
Mass replace "TemplateVM" with "template"
QubesOS/qubes-issues#1015
2021-06-18 02:16:40 -07:00
Andrew David Wong
c07ee61ed8
Mass replace "DisposableVM" with "disposable"
QubesOS/qubes-issues#1015
2021-06-18 02:04:39 -07:00
Andrew David Wong
aea595397f
Mass replace "AppVM" and "TemplateBasedVM" with "app qube"
QubesOS/qubes-issues#1015
2021-06-18 01:55:53 -07:00
Andrew David Wong
719836c9f3
Replace "template-based qube" with "app qube"
See #748 and the glossary.
2021-06-18 01:34:07 -07:00
Andrew David Wong
4f3c513422
Update template doc
- Replace "TemplateVM" with "template" (QubesOS/qubes-issues#1015)
- Update other terminology
- Miscellaneous improvements
2021-06-18 01:22:23 -07:00
Andrew David Wong
d2614cbd5f
Fix links 2021-06-17 09:23:17 -07:00
Andrew David Wong
76150ac9d3
Fix links 2021-06-17 07:01:53 -07:00
Andrew David Wong
7805c486f4
Merge branch 'master' of github.com:QubesOS/qubes-doc into auto-gen 2021-06-17 05:52:00 -07:00
Andrew David Wong
6d81f95cc2
Update and reorganize documentation
- Convert "Common Tasks" to "How-to Guides"
  (QubesOS/qubes-issues#6694)
- Make title capitalization consistent across docs
- Fix leftover h1 headings
- Reorganize various pages and topics
- Update permalinks to better match titles
- Create redirects for changed permalinks
- Miscellaneous cleanup

QubesOS/qubes-issues#6701
2021-06-17 05:16:22 -07:00