Commit Graph

147 Commits

Author SHA1 Message Date
Marek Marczykowski-Górecki
4017d11de3
Run script to add 'ref' parameters 2021-06-24 18:19:05 +02: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
d145143261
Update Qubes Canary page link 2021-06-22 10:55:21 -07:00
Andrew David Wong
6cc2f9932b
Update QSB page link 2021-06-22 10:50:12 -07:00
Andrew David Wong
527a2eb339
Update links 2021-06-21 00:38:18 -07:00
Andrew David Wong
bc138e0dc4
Update links 2021-06-20 21:54:36 -07:00
Andrew David Wong
6a88601739
Update "Testing New Releases and Updates"
- Convert alert into text warning
  (Now that every advanced page has the same sticky alert at the top,
  it looks odd to have similar alerts above and below the h1 heading.)
- Update heading syntax
- Wrap text
2021-06-19 21:06:40 -07:00
Andrew David Wong
cc839fc10a
Move "Version Scheme" to developer docs
This page appears to be written for a developer audience.
2021-06-19 20:41:11 -07:00
Andrew David Wong
2dbc8865e1
Use doc layout instead of sidebar layout
There appears to be no strong reason that these pages are using a
different layout, and having this separate layout significantly
increases the ongoing doc maintenance burden.
2021-06-19 20:39:34 -07:00
Andrew David Wong
a2511357a7
Mark pages as advanced 2021-06-19 02:36:05 -07:00
Andrew David Wong
2c7982d391
Restore capitalization 2021-06-18 06:35:43 -07:00
Andrew David Wong
07c130df00
Wrap text and miscellaneous cleanup 2021-06-18 06:25:06 -07:00
Andrew David Wong
e451f92cde
Update attachment paths 2021-06-18 05:46:02 -07:00
Andrew David Wong
60bd80ad25
Revert "Update attachment paths"
This reverts commit e5a21f7488.
2021-06-18 05:39:47 -07:00
Andrew David Wong
e5a21f7488
Update attachment paths 2021-06-18 05:02:02 -07:00
Andrew David Wong
88a4e0a4b5
Fix links 2021-06-18 02:59:26 -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
7d3fd4fa26
Create general Privacy Policy; add mirror note
Based on @unman's proposal:
c52aaa6821

Original context:
https://qubes-os.discourse.group/t/qubes-website-privacy-policy/2235/
2021-06-17 11:06:21 -07:00
Andrew David Wong
76150ac9d3
Fix links 2021-06-17 07:01:53 -07:00
Andrew David Wong
59a4c8df11
Update links
QubesOS/qubes-issues#6701
2021-06-17 05:48:32 -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
Andrew David Wong
12408884dd
Clean up YAML titles and create redirect stubs
QubesOS/qubes-issues#6701
2021-06-17 02:40:43 -07:00
Andrew David Wong
2c473241a8
Revert "Remove all instances of permalink: in YAML frontmatter"
This reverts commit c815e4c54c.

https://github.com/QubesOS/qubes-issues/issues/6701#issuecomment-862822827
2021-06-16 19:56:25 -07:00
Andrew David Wong
4ff7430960
Remove redundant h1 titles using # syntax
https://github.com/QubesOS/qubes-issues/issues/6701#issuecomment-862060759
2021-06-16 00:29:28 -07:00
Andrew David Wong
a4cbb51092
Remove vestigial '====' heading syntax
https://github.com/QubesOS/qubes-issues/issues/6701#issuecomment-862060759
2021-06-15 23:53:27 -07:00
Andrew David Wong
f822b70435
Remove redundant titles
First pass for all titles still using the old '=====' syntax

https://github.com/QubesOS/qubes-issues/issues/6701#issuecomment-862060759
2021-06-15 23:48:48 -07:00
Andrew David Wong
0c95b3ae4d
Revert "Remove instances of title: from YAML headers"
This reverts commit 24e6a8a616.

https://github.com/QubesOS/qubes-issues/issues/6701#issuecomment-862060759
2021-06-15 23:19:45 -07:00
Andrew David Wong
c815e4c54c
Remove all instances of permalink: in YAML frontmatter
Converts existing permalink paths into redirect_from entries.

QubesOS/qubes-issues#6701
2021-06-15 22:33:51 -07:00
Andrew David Wong
24e6a8a616
Remove instances of title: from YAML headers
QubesOS/qubes-issues#6701
2021-06-15 22:16:59 -07:00
Andrew David Wong
9e9a3e6837
Update testing page
- Convert text warning into alert; add text
- Minor language improvements and fixes
- Normalize heading capitalization
2021-06-12 19:29:17 -07:00
Andrew David Wong
0ff457791c
Update Supported Versions: TemplateVMs
- Explain passing along upstream EOL notices
 - Add note regarding Debian 9 support in R4.0
 - Add section on Debian support policy
2021-06-07 17:27:49 -07:00
Andrew David Wong
898b14a2bd
End Fedora 32 TemplateVM support (EOL) 2021-05-25 09:05:35 -07:00
Tobias Killer
098f5b418c
Resolve open issues mentioned on Transifex 2021-04-17 10:57:16 +02:00
Andrew David Wong
d2fa42c1e9
Merge branch 'md-refactoring-links' of https://github.com/tokideveloper/qubes-doc into tokideveloper-md-refactoring-links 2021-04-15 08:57:06 -07:00
Andrew David Wong
26f3a6567b
Fix broken link syntax cases
Thank you to Tokidev for pointing these out.
2021-04-12 13:40:09 -07:00
Tobias Killer
b6cb04c297
Refactor links in order to obey the new convention rule 2021-04-11 00:09:05 +02:00
Maya
820af56761
Add lang + ref tags to frontmatter
Those are fields used by the language switcher to correlate pages across
different languages, even if they have different names/paths/titles.
They are generated with the prepare_for_translation.py script.
2021-03-14 16:18:11 +01:00
Maya
8f8a8e50ea
Normalize frontmatter
- sort keys
- remove permalink from redirects
2021-03-14 16:18:10 +01:00
Maya
67a92614aa
Markdown formatting fixes
- mark all code blocks with ```
- unify empty lines between sections
- adjust list syntax (no space before dash)
- adjust headers to use Atx-style syntax
- remove trailing spaces
2021-03-14 16:18:10 +01:00
Maya
2bde7d07e0
Rename files to avoid dots in the path
This is problematic for Transifex API and also ease building
language-specific links.
2021-03-13 20:11:39 +01:00
Andrew David Wong
d9de60a551
Add Fedora 33 to supported templates for 4.0, 4.1
QubesOS/qubes-issues#6039
2021-02-24 16:49:11 -08:00
Andrew David Wong
aaa2aa1ad2
Clarify text 2021-01-03 11:59:10 -08:00
Andrew David Wong
401447bcde
Encourage users to stay informed of QSBs
- Add "Next steps: Security" section to installation guide
 - Add social media section to support page, as a way to receive news
   updates

Discussed in:
 - QubesOS/qubes-issues#6299
 - https://qubes-os.discourse.group/t/safety-when-forced-not-to-use-updater/2085
2021-01-03 08:08:37 -08:00
Andrew David Wong
6dd31abb80
Undo R1 and R2 version scheme retcon 2020-11-27 07:36:30 -08:00
Andrew David Wong
d9aad865d7
Reorganize Supported Versions page TemplateVM sections
- Consolidate tables to avoid need for cross-referencing
 - Drop unsupported versions
 - Consolidate and clarify TemplateVM version support policies
 - Make formatting and language more consistent
2020-11-26 06:21:47 -08:00
Andrew David Wong
198b9e6bc8
Clarify Debian TemplateVM support policy 2020-11-26 05:50:25 -08:00
Andrew David Wong
1b12cbc8d6
Suggest submitting HCL report after installation
QubesOS/qubes-issues#6231
2020-11-25 05:02:09 -08:00
Andrew David Wong
54fde72b02
Fix example order 2020-11-24 08:10:14 -08:00
Andrew David Wong
116cb05f4e
Update Fedora 31 support status
Fedora 31 has reached EOL.
2020-11-24 08:08:27 -08:00
PROTechThor
fa61755afd Amend installation guide and troubleshooting 2020-11-03 14:51:22 +01:00
Andrew David Wong
715e50236e
Improve installation destination warning 2020-09-26 05:49:42 -05:00
Andrew David Wong
f56bf6c037
Improve instructions for installing onto USB drives 2020-09-26 05:44:26 -05:00
Andrew David Wong
604bec3ddd
Remove deprecated Live USB page, redirect to Installation Guide 2020-09-14 03:19:25 -05:00
Andrew David Wong
9119bba439
Improve cross-linking of important documentation pages 2020-09-13 08:52:31 -05:00
Andrew David Wong
bb4acaeac1
Revise installation guides
These revisions focus mainly on improving language, presentation, and
organization. The core instructions are largely preserved, though some
new information and links to other resources are added.
2020-09-01 22:49:41 -05:00
Andrew David Wong
122fa55ead
Add sections on updating and backups 2020-08-31 15:39:30 -05:00
Andrew David Wong
96399b2593
Add section on trusting hardware 2020-08-31 15:37:25 -05:00
Andrew David Wong
60864a532c
Update qubes-users references to /support/
Now that we have a user forum in addition to qubes-users, it makes more
sense to link to /support/ than to link directly to qubes-users (or to
the forum, for that matter). This layer of redirection means allows us
to update just one thing (namely, the /support/ page) instead of having
to hunt through all the documentation every time support information
changes.
2020-08-22 23:18:08 -05:00
Marek Marczykowski-Górecki
d6ab2a6dba
Update supported versions
- remove old templates that are not going to be available in R4.1
- Fedora 30 is EOL now
2020-07-27 00:21:29 +02:00
Andrew David Wong
17efdc53d1
Update R4.1 dom0 OS to Fedora 32
QubesOS/qubes-issues#5923
2020-07-07 06:14:02 -05:00
Andrew David Wong
931e6b9a50
Update dead link
Thank you to user Bruno for pointing this out and supplying a
replacement link.
2020-07-01 06:38:36 -05:00
Andrew David Wong
6ab14dd9d2
Update Supported Versions with Fedora 32 template 2020-06-30 06:07:01 -05:00
Sarvottam Kumar
e26c8ab552
Update installation-guide.md 2020-05-16 23:05:17 +05:30
Andrew David Wong
bda320f1ad
Add Fedora 31 to Qubes 4.0 row and general support list 2020-04-30 08:58:54 -05:00
Death Grippin
52f482bcd3
Fix minor typos 2020-03-14 15:48:12 -04:00
Andrew David Wong
19cf9381b7
Merge branch 'replace-4.0.1-install-warning' 2020-01-26 08:08:19 -06:00
mfp20
63140c9c67
Link OpenQA into docs
In order to allow testers to look ahead and figure out the current status, development efforts, and so on.
2020-01-13 19:50:11 +01:00
Andrew David Wong
141212e37f
Replace 4.0.1 warning with general intro 2020-01-09 05:37:59 -06:00
shadowmax31
b8d5b97d0d
Correct typo 2019-12-15 19:36:33 -05:00
Andrew David Wong
fdefb947a4
Correction: R4.1 will run fc31 in dom0, not fc29 2019-12-02 08:03:33 -06:00
Andrew David Wong
c1a053afdc
Add R4.1's dom0 Fedora version 2019-12-01 18:01:35 -06:00
Andrew David Wong
2f2a2faa0a
Merge branch 'master' of github.com:QubesOS/qubes-doc into template-support 2019-12-01 01:08:17 -06:00
Andrew David Wong
b347ec9efd
Reorganize template section 2019-12-01 01:07:54 -06:00
Andrew David Wong
08f60d9747
Add entry for Qubes R4.1 2019-12-01 01:03:02 -06:00
Andrew David Wong
2a08e6aa5d
Simply support status keywords 2019-12-01 01:02:29 -06:00
Andrew David Wong
241c91a988
Fix link 2019-11-30 00:33:18 -06:00
Andrew David Wong
57b9a6daad
Distinguish between template availablity and support status
QubesOS/qubes-issues#5489
2019-11-30 00:21:07 -06:00
Andrew David Wong
8b43922b70
Fix typo 2019-11-29 23:51:06 -06:00
Lukas
0795e8aeeb
Update installation guide
- Replaced <h3>Title</h3> with ### Title ###
- Broke lines between sentences, including inside HTML code
- Use markdown syntax for images
2019-11-29 18:18:36 -06:00
Lukas
f1c783e0f0
Updated Installation Guide #5471
I have added most of Marek's suggestions. I don't know how to solve the markdown HTML and formatting issue. (I believe alert boxes are great and should be used to make it more visually appealing but alas, it may be a bit too late to settle on this)
2019-11-27 13:07:41 -06:00
Andrew David Wong
73d918b905
Add/update Rufus images provided in #892 2019-11-26 01:56:32 -06:00
Theodore Chu
6e042175bb
Update installation-guide.md
Latest versions of Rufus tool ask for "dd" image. It doesn't show on the menu as in the picture.
2019-11-24 13:20:19 -08:00
rafaelreis-r
b6afa9270c
Update custom-install.md
1 - Inform the user how to return to installation @ step 8;
2 - Clarify the need to choose a FS and format prior to assigning the mount points (option is greyed out until you do).  @ step 9
3 - Guide the user on navigating the quirky behaviour of Anaconda on that part - You have to first check the box, then choose FS, then enter mount point, from bottom to top, which is not really friendly. @ step 9

Future TODO: Include details for GPT / UEFI disks. Boot mount point and FS are different, as well as the disk initialization part with fdisk (step 2).
2019-11-07 11:54:11 -03:00
Andrew David Wong
fa91c0478b
Update ISO copying instructions for larger ISO size
Suggest USB drives first. For optical media, explicitly suggest
dual-layer DVDs and Blu-ray discs rather than just "DVDs."
2019-11-06 00:32:58 -06:00
Andrew David Wong
05d159becf
Update Hardware Requirements section 2019-10-06 17:39:09 -05:00
Andrew David Wong
a486525edf
Updated Supported Versions page
- Add brief intro
- Unwrap lines
- Clarify Whonix information
- Link to Whonix Project website
- Link to Fedora and Debian pages
2019-09-02 11:38:00 -05:00
Andrew David Wong
1d554658bc
Fix links 2019-09-02 05:03:21 -05:00
Andrew David Wong
233bbd8ae0
Clarify exception for critical security updates 2019-08-26 18:00:47 -05:00
Andrew David Wong
b59fc0a41c
Document testing practices (QubesOS/qubes-issues#4846) 2019-08-26 17:57:50 -05:00
Andrew David Wong
fe6f991c01
Create new user overview on updating Qubes OS 2019-07-08 21:23:30 -05:00
airelemental
73a0c9e70e
Add buster, whonix-15 2019-07-06 01:48:31 +00:00
Andrew David Wong
5554bf4e5e
Add Fedora 30 to supported 4.0 templates
QubesOS/qubes-issues#4845
2019-06-01 15:27:54 -05:00
Andrew David Wong
d31c786942
Reorganize files to account for new "External" section
QubesOS/qubes-issues#4693
2019-05-26 19:32:45 -05:00