Commit Graph

960 Commits

Author SHA1 Message Date
Yanase Yuki
8a0ba67406
Fix SaltStack document links 2021-07-20 19:32:37 +09:00
Andrew David Wong
54525b2e09
Update links; fix typo 2021-07-20 03:27:51 -07:00
Dave Smith
d01ad9c33e
Fix htmlproofer errors in PRs #1176 & #1177...
caused by hcl.md file rename in qubes-doc commit 7d894a59.
2021-07-16 01:15:15 -05:00
Andrew David Wong
db56549748
Move files back to qubes-doc so they can appear in index
I'm still not sure why these files have to be in qubes-doc in order to
appear in the doc index, but they do, so I'm moving them back even
though they're mostly empty.
2021-07-14 11:20:16 -07:00
Andrew David Wong
7d894a5971
Update filename to match new title 2021-07-14 11:16:34 -07:00
Andrew David Wong
c001d2136b
Update title to distinguish from main HCL page
Moving redirects to main HCL page in a separate commit.
2021-07-14 11:15:29 -07:00
Andrew David Wong
4ff7399334
Copyedit 2021-07-13 15:28:42 -07:00
Dave Smith
13f799725f
Fix link to HTML syntax (#1174) 2021-07-12 08:09:26 -05:00
Dave Smith
4055787313
Add clarification based on PR #1174 feedback 2021-07-11 22:38:26 -05:00
Dave Smith
d4d00ef9d1 Tag for commit 6eea2bf394
-----BEGIN PGP SIGNATURE-----
 
 iQIzBAABCgAdFiEE4R0VxtIENXaf+qRWjOE3NSoBmhcFAmDqGVAACgkQjOE3NSoB
 mhcsdg/6A2zT+GvdR0XtnGxyJoI1WDTHrTSt9e0BiVOWorCs1OoL85leR0jvzWgO
 hcXeIxiQK7EnG/QKQC1UMY3gSfL+t8bkaGlXVqcNPFdbVIiHqg/w0KuMaA1pq4mQ
 slGtcZyQjjWLLm8RiL4KxshnqVZWqokQwOg3GwL72bNvVxOGb5nJAI9VIyq9+C6N
 rqE3qUg3CkzVUxjEFh8kNjGGc/SrpWRlXDHr/6+L5BgGKGcXjhy3S480yRNHU5LI
 V/xqkFa+QJaA5F0E+2CIX+fuHSQGl8HrupdXltBRT4VYTibLICGAPsiibpETSrNX
 f0lPXUfJAQINw9MAWEvypuFhCHc21xwV/KHVymGuUsbLVFsSUDFrAimb9zBxvqRC
 MNAnIBcwrvgxBBg2P4XVTLaV6fKe8vGf3fuiV0Rlxpjk/5oq8KKwCc9LeSd1Q+Sq
 hHV72j/yOpXe/FJ10eWMJQLoOGUk/aMu8gAhpjSMBzuDV9kmwp3H2eNNrTrU3hxW
 UAvSaNTCK+klmNTWfiPKDaQCtJFhrBqglzo/yNo0JUBhpP6azZ41ISU9pd9lamc5
 kbBWioRjeb6hQ+aBgU6W2UY+q9S6gyvITpfB+PmjU+HzCUqoxpKKe2epQnnm63Tn
 46eceH/DdlFWZcRP0Zi2aMsdyylwRaGVoRASwb90JKRtfVSEd58=
 =gYJ6
 -----END PGP SIGNATURE-----
gpgsig -----BEGIN PGP SIGNATURE-----
 
 iQGzBAABCAAdFiEE2igx/unaOtbQrvi8nUlmN9gUhKYFAmDrOeAACgkQnUlmN9gU
 hKYoCwv/RQXtJxSkEz79FaVQHFb2Jw2MK5Gl1W6mjDbOSHvyPJEHH04ZzQnIQKZX
 cYGSTvXoSiqdLwlFi+vGZXqdWPYprOCjDKDz0E+0Mxh4gr6FKY9NNlq335wN1ePg
 AEoHI78OzRHhyUBVJuEpS6MAHl45xkxbC6wsBvx+23/rSit5aNopghtiE7Ln/RlO
 fxfUUrYbA3sMr8TvxSiMSr6KkjFWZU44s5Gu+PH/N/iTmbYbSXmCvMP6j9V1BwKq
 2JDyGXIdqpGztAojiWDNL+b7lV0+Bd1QXh3BnBJ6H9u3TpqNC0nihPeATlV0SJi8
 dG1AB87/dv6NiZo4v5MH+yYIHyYNhte8vvPeN3NqoMHr4M9t3p9SviJc9+sVFDwZ
 X0eBx1aaZT7PDex2EPX9eHIVgBkzuhuMab9l5+zXDril+g/KOGPHwmk11PeEb3mA
 FNuo6HKwxuD0zVzPN0vQmcHG1nIl612sugI9J0bp6ZmaFdlApKa6UP57jE0I8Qg0
 Jz8IC2qg
 =hQrV
 -----END PGP SIGNATURE-----

Merge tag 'adw_6eea2bf3'

Tag for commit 6eea2bf394

# -----BEGIN PGP SIGNATURE-----
#
# iQIzBAABCgAdFiEE4R0VxtIENXaf+qRWjOE3NSoBmhcFAmDqGVAACgkQjOE3NSoB
# mhcsdg/6A2zT+GvdR0XtnGxyJoI1WDTHrTSt9e0BiVOWorCs1OoL85leR0jvzWgO
# hcXeIxiQK7EnG/QKQC1UMY3gSfL+t8bkaGlXVqcNPFdbVIiHqg/w0KuMaA1pq4mQ
# slGtcZyQjjWLLm8RiL4KxshnqVZWqokQwOg3GwL72bNvVxOGb5nJAI9VIyq9+C6N
# rqE3qUg3CkzVUxjEFh8kNjGGc/SrpWRlXDHr/6+L5BgGKGcXjhy3S480yRNHU5LI
# V/xqkFa+QJaA5F0E+2CIX+fuHSQGl8HrupdXltBRT4VYTibLICGAPsiibpETSrNX
# f0lPXUfJAQINw9MAWEvypuFhCHc21xwV/KHVymGuUsbLVFsSUDFrAimb9zBxvqRC
# MNAnIBcwrvgxBBg2P4XVTLaV6fKe8vGf3fuiV0Rlxpjk/5oq8KKwCc9LeSd1Q+Sq
# hHV72j/yOpXe/FJ10eWMJQLoOGUk/aMu8gAhpjSMBzuDV9kmwp3H2eNNrTrU3hxW
# UAvSaNTCK+klmNTWfiPKDaQCtJFhrBqglzo/yNo0JUBhpP6azZ41ISU9pd9lamc5
# kbBWioRjeb6hQ+aBgU6W2UY+q9S6gyvITpfB+PmjU+HzCUqoxpKKe2epQnnm63Tn
# 46eceH/DdlFWZcRP0Zi2aMsdyylwRaGVoRASwb90JKRtfVSEd58=
# =gYJ6
# -----END PGP SIGNATURE-----
# gpg: Signature made 7/10/2021 5:04:00 PM Central Daylight Time
# gpg:                using RSA key E11D15C6D20435769FFAA4568CE137352A019A17
# gpg: Can't check signature: No public key
2021-07-11 13:35:12 -05:00
Dave Smith
cc8155ff9f
Undo change to 'Copying the ISO' header, not worth the broken links 2021-07-11 13:30:32 -05:00
Andrew David Wong
65f032a45c
Update patch release description for accuracy 2021-07-10 14:42:17 -07:00
Andrew David Wong
26b1a4d6db
Change "point relase" to "patch release" for precision
In general, the software world is not clear about these terms. However,
the most common usage seems to use "point release" to refer to any
release with at least one period in the version number, which would also
include minor releases. By contrast, "patch release," though a much less
common phrase, unambiguously denotes a release with a version number
containing two periods.

See:
https://en.wikipedia.org/wiki/Point_release
https://semver.org/
2021-07-10 14:29:48 -07:00
Andrew David Wong
ca0ccab949
Update titles and links 2021-07-10 14:25:29 -07:00
Andrew David Wong
039f2f87b9
Update filename 2021-07-10 13:52:46 -07:00
Andrew David Wong
7ecbf8f530
Change "version" to "release"
See https://github.com/QubesOS/qubes-issues/issues/5308#issuecomment-877700342
2021-07-10 13:50:26 -07:00
Andrew David Wong
3f0977be1b
Fix typo; improve image titles (#1172) 2021-07-10 12:39:28 -07:00
Andrew David Wong
380e7b43b9
Fix and improve installation guide (#1172)
- Improve language
- Fix image links
- Explain BIOS and UEFI, provide links
- Fill in missing steps and information gaps
- Standardize grammar and punctuation
- Improve formatting
- Clarify instructions and explanations
2021-07-10 12:22:46 -07:00
Andrew David Wong
0309e79ca8
Merge branch 'patch-23' of https://github.com/deeplow/qubes-doc into deeplow-patch-23 2021-07-10 11:33:47 -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
Dave Smith
64b1015e17
Reduce Windows confusion in renamed 'Installation medium preparation' section 2021-07-07 22:12:46 -05:00
deeplow
f4e726c818
minor changes 2021-07-06 20:33:54 +00:00
deeplow
9d2bc4341f
Replace all BIOS mentions with BIOS/UEFI 2021-07-06 20:27:05 +00:00
deeplow
a448289442
remove duplicated information about boot device 2021-07-06 20:18:03 +00:00
deeplow
b3d9e00bae
Update installation-guide.md 2021-07-06 20:01:55 +00:00
gw0
ad6bcf7fb4 Update resume-suspend-troubleshooting.md 2021-07-06 13:19:15 +02:00
Andrew David Wong
9d390bdb0d
Use Markdown syntax instead of HTML
Although the HTML tags are technically correct, it's probably more
important to preserve source readability and avoid the problems that
HTML-in-Markdown poses for localization and offline documentation.
2021-07-06 02:06:50 -07:00
deeplow
9e0de52023
add info on boot menu (part 1) 2021-07-05 18:41:06 +00: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
41ed804361
Wrap text; improve wording 2021-07-05 05:35:57 -07:00
Andrew David Wong
440ca6a597
Update Whonix links; add Privacy Policy links 2021-07-05 05:26:21 -07:00
Andrew David Wong
bae794951d
Capitalize second word in title case compound adjectives
https://github.com/QubesOS/qubes-issues/issues/6756#issuecomment-873385039
2021-07-04 03:35:59 -07:00
Andrew David Wong
28bfb5c224
Capitalize second word in title case compound adjectives
https://github.com/QubesOS/qubes-issues/issues/6756#issuecomment-873385039
2021-07-03 15:43:16 -07:00
Andrew David Wong
86cdf83aed
Merge branch 'patch-2' of https://github.com/ninavizz/qubes-doc into ninavizz-patch-2 2021-07-03 04:19:16 -07:00
Andrew David Wong
3806744ce0
Fix capitalization
https://github.com/QubesOS/qubes-doc/pull/1169/files#r663353238
2021-07-03 04:18:32 -07:00
Andrew David Wong
5220089b53
Update references to "Getting Started"
QubesOS/qubes-issues#6756
2021-07-03 03:46:27 -07:00
Andrew David Wong
ca109b05c7
Change name back to "Getting Started" and move to intro
QubesOS/qubes-issues#6756
2021-07-03 03:40:13 -07:00
Nina Eleanor Alter
dc0433edcd
Update how-to-use-block-storage-devices.md
Remove use of the phrase "GUI" and specifically speak to the "Devices WIdget." Especially since it is now referenced in the Getting Started section, which should cross-link, here.
2021-07-02 14:58:59 -07:00
Andrew David Wong
baa1df911c
Update Qubes Forum URLs 2021-07-01 07:03:05 -07:00
Andrew David Wong
d9b061f8f7
Copyedit 2021-06-26 06:24:32 -07:00
Andrew David Wong
871d281320
Update title and permalink to match filename 2021-06-26 06:10:49 -07:00
Andrew David Wong
10cdaf3cdf
Fix filename to conform to section naming scheme 2021-06-26 06:09:15 -07:00
Andrew David Wong
0c699de048
Merge branch 'skip-autostart' of https://github.com/fepitre/qubes-doc into fepitre-skip-autostart 2021-06-26 06:06:01 -07:00
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
Frédéric Pierret (fepitre)
bccc64d480
skip-autostart: precise supported releases and modes 2021-06-23 18:46:20 +02:00
Frédéric Pierret (fepitre)
069c805d04
troubleshooting: add qubes.skip_autostart
Related QubesOS/qubes-issues#4312
2021-06-23 16:28:03 +02:00
Andrew David Wong
3b700bfa63
Update "Standalones and HVMs"
- Add and update links
- Update terminology
- Fix and improve syntax
- Clarify command-line variables
- Fix headings
- Improve language
- Make syntax consistent
- Remove deprecated and inaccurate information
- Improve grammar and orthography
- Fix typos
- Wrap text

Related to #1164
2021-06-23 01:48:00 -07:00
deeplow
3b4c9bf434
Make replaceable text like <THIS> instead of <this> 2021-06-23 07:55:18 +00: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
6fa8777f37
Clarify and simplify language 2021-06-22 06:56:10 -07:00
Andrew David Wong
c2397776ac
Merge branch 'patch-1' of https://github.com/ninavizz/qubes-doc into ninavizz-patch-1 2021-06-22 06:47:22 -07:00
Andrew David Wong
f97eaa7b94
Move HCL listing page to main repo
This file contains no significant content.
2021-06-22 01:26:38 -07:00
Andrew David Wong
a015f60087
Fix links 2021-06-21 18:39:21 -07:00
Nina Eleanor Alter
6547239de9
Update how-to-get-started.md
- Added line-item for "Clipboard" widget in 'Unique Items' area
- Re-ordered bulleted items to follow L-R ordering of items in image
2021-06-21 15:42:50 -07:00
Andrew David Wong
1e7a76ffa7
Fix capitalization 2021-06-21 04:12:33 -07:00
Andrew David Wong
74a547ae14
Update "How to Use Disposables"
- Restore old redirect
- Add glossary links
- Update terms
- Fix capitalization
2021-06-21 04:06:25 -07:00
Andrew David Wong
527a2eb339
Update links 2021-06-21 00:38:18 -07:00
Andrew David Wong
58200e52ce
Add glossary links; improve wording 2021-06-20 22:50:30 -07:00
Andrew David Wong
7d30b685bf
Update title for accuracy 2021-06-20 22:49:41 -07:00
Andrew David Wong
d31155a89e
Add entry for "management qube" 2021-06-20 22:49:09 -07:00
Andrew David Wong
435f2f655e
Update "How to Update"
- Create new "Command-line interface" section
- Move warning about direct commands to new section
- Move info about qubesctl commands and testing repos to new section
- Revise "Upgrading" section
2021-06-20 22:27:43 -07: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
bc138e0dc4
Update links 2021-06-20 21:54:36 -07:00
Andrew David Wong
87948a3d0d
Update URL to match title 2021-06-20 20:55:57 -07:00
Andrew David Wong
92016a6ba1
Update "How to Install Software"
- Improve intro
- Make key instruction steps harder to miss
- Add "Troubleshooting" section
- Move text on updating standalones to "Standalones and HVMs"
2021-06-20 20:43:43 -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
09ba96bbd6
Rename "awesome" to "AwesomeWM"; update image, links
Based on examining the AwesomeWM project's web presences and Wikipedia
entry, there does not appear to be a single consistent name by which the
project refers to its window manager. All three of these variations are
used: "awesome", "Awesome", and "AwesomeWM". In order to avoid ambiguity
with the regular English word, we're opting for "AwesomeWM" in our own
documentation.

This commit also reverts the change to the widget image, since that
change was not necessary (see #1161).

Finally, this commit adds links to the KDE, i3, and AwesomeWM pages.
2021-06-20 19:04:09 -07:00
Andrew David Wong
0b95303b3c
Merge branch 'patch-1' of https://github.com/ninavizz/qubes-doc into ninavizz-patch-1 2021-06-20 18:46:46 -07:00
Andrew David Wong
61c38685ef
Add trailing slash 2021-06-20 18:27:31 -07:00
noskb
1e469ea089
Fix redirect to 404 from /doc/disposablevm
The link appears on the first page of a search result for "qubes disposable", but it is not redirecting correctly.
2021-06-21 00:38:18 +00:00
Nina Eleanor Alter
3cca147caa
Update how-to-get-started.md
- Updated image to match wording to names shown above
- Edited "custom" to "unique" wrt "unique to qubes," as sdwdate is not custom _to_ qubes, but is unique(ish) to Qubes.
- Included bullet for Whonix widget, w/ link-out
- Capitalized "A" on Awesome in desktop environments
2021-06-20 15:47:56 -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
f490482273
Update "How to Install Software in Dom0"
- 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.)
- Fix headings
- Fix syntax
- Wrap text
2021-06-19 21:01:26 -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
04d3ead8bf
Fix "Notes" heading; update heading syntax 2021-06-19 20:06:33 -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
7c0a29a253
Add entry for "netvm" 2021-06-18 22:27:46 -07:00
Andrew David Wong
0a53418de1
Update glossary
- Add entry for "admin qube"
- Add entry for "named disposable" (QubesOS/qubes-issues#6709)
- Clarify disposable-related definitions (QubesOS/qubes-issues#6709)
- Add "previously known as" terms
- Clarify wording in various entries
2021-06-18 20:34:02 -07:00
Andrew David Wong
ba232b6b58
Improve organization and wording; fix typos 2021-06-18 12:23:43 -07:00
Andrew David Wong
b3c61ed5c0
Clarify definitions 2021-06-18 12:08:33 -07:00
Andrew David Wong
c178da955e
Update "How to Install Software"
- Explicitly state that software should be installed in a template
- Add a note for advanced users who might be interested in installing
  software in standalones and dom0
- Fix Markdown syntax and formatting
- Wrap text
2021-06-18 06:58:10 -07:00
Andrew David Wong
3d1d8bf37e
Update links 2021-06-18 06:47:40 -07:00
Andrew David Wong
f50d543155
Fix errors 2021-06-18 06:42:30 -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
50270f435c
Fix links 2021-06-18 03:09:09 -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
719836c9f3
Replace "template-based qube" with "app qube"
See #748 and the glossary.
2021-06-18 01:34:07 -07:00
Andrew David Wong
132030119f
Update "How to Install Software"
- Update terminology (QubesOS/qubes-issues#1015)
- Add section on lack of template network access
- Move advanced topics to "Advanced" section
- Miscellaneous improvements
2021-06-18 01:25:09 -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
e9fe17f2f2
Fix link text capitalization 2021-06-18 01:21:40 -07:00
Andrew David Wong
873da01b7b
Shorten "standalone qube" to "standalone"
Similar to "templates" and "disposables."
QubesOS/qubes-issues#1015
2021-06-18 01:19:44 -07:00
Andrew David Wong
7652e7edf8
Revamp glossary
- Replace "VM" with "qube" (QubesOS/qubes-issues#1015)
- Remove deprecated terms
- Remove some terms that are not Qubes-specific
- Alphabetize entries
- Miscellaneous improvements
2021-06-18 00:48:17 -07:00
Andrew David Wong
7f54374791
Merge branch 'patch-19' of https://github.com/deeplow/qubes-doc into deeplow-patch-19 2021-06-17 11:22:48 -07:00
Andrew David Wong
74eb0d923a
Restore language indicating examples 2021-06-17 11:22:34 -07:00
Andrew David Wong
dc4fee50e0
Merge branch 'patch-19' of https://github.com/deeplow/qubes-doc into deeplow-patch-19 2021-06-17 11:21:16 -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
deeplow
f0ce0cc4ca
remove "install windows or mac"
Generally people don't install these systems. They just come per-installed.
2021-06-17 16:57:03 +00:00
Andrew David Wong
d2614cbd5f
Fix links 2021-06-17 09:23:17 -07:00
Andrew David Wong
2ae7a9c897
Revamp "How to Get Started" page
Closes QubesOS/qubes-issues#6694
2021-06-17 09:06:48 -07:00
Andrew David Wong
a63f24d639
Fix links 2021-06-17 07:33:36 -07:00
Andrew David Wong
76150ac9d3
Fix links 2021-06-17 07:01:53 -07:00
Andrew David Wong
d4c577e31b
Fix links 2021-06-17 06:54:52 -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
59a4c8df11
Update links
QubesOS/qubes-issues#6701
2021-06-17 05:48:32 -07:00
Andrew David Wong
a3077032c3
Improve text 2021-06-17 05:32:09 -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
ejd1967
db6333951f
Update fedora-upgrade.md 2021-06-17 14:08:27 +03: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
aca8ed14c7
Normalize instances of redirect_from:
QubesOS/qubes-issues#6701
2021-06-15 22:24:44 -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
cbd5a6c10e
Steer newbies away from in-place upgrades even more
https://qubes-os.discourse.group/t/cat-etc-fedora-release-what-to-do-if-wrong-version/4510/6
2021-06-15 21:22:35 -07:00
Andrew David Wong
78e9d77401
Add section on security updates
Also some minor language and syntax improvements
2021-06-14 21:46:52 -07:00
Andrew David Wong
c0e7729500
Convert to standard doc layout with sidebar
See QubesOS/qubes-issues#6694
2021-06-13 20:45:21 -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
a7311f35e7
Add link to testing page 2021-06-12 19:28:55 -07:00
deeplow
65a492b77d
QubesOS -> Qubes OS 2021-06-12 11:13:28 +00:00
Andrew David Wong
49b75f3e21
Merge branch 'supported-versions-templates' 2021-06-11 21:28:49 -07:00
Andrew David Wong
7caa0d5ac4
Merge branch 'master' of https://github.com/ctrlaltf24/qubes-doc into ctrlaltf24-master 2021-06-07 17:37:56 -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
3bcbb3a077
Update certified laptops, add NitroPad T430 2021-06-01 12:26:30 -07:00
Andrew David Wong
612687e002
Replace $ with @ 2021-05-29 14:28:07 -07:00
Suzanne Soy
cd0a56d979 RPC policies: example with $default and qvm-copy (prompts for destination VM)
Closes https://github.com/QubesOS/qubes-issues/issues/4403
2021-05-29 22:14:47 +01:00
Andrew David Wong
898b14a2bd
End Fedora 32 TemplateVM support (EOL) 2021-05-25 09:05:35 -07:00
Andrew David Wong
58f9a3fc12
Increase min memory req from 4 GB to 6 GB (#1144) 2021-05-20 06:20:05 -07:00
HackerNCoder
209e07557f
Remove 1 from appvm-shortcuts so image displays 2021-05-14 15:35:02 +00:00
Andrew David Wong
c114804889
Update manual redirect 2021-05-13 06:48:00 -07:00
Andrew David Wong
db08dee7b9
Improve instructions for uninstalling templates 2021-05-13 06:38:07 -07:00
ctrlaltf24
94d205a2b6
added qvm-convert domU
Relies on https://github.com/QubesOS/qubes-app-linux-img-converter/pull/13
2021-05-10 19:22:02 -07:00
Andrew David Wong
50b1611cac
Clarify release upgrades; add section headings 2021-05-10 12:50:50 -07:00
Andrew David Wong
de4455d7a8
Clarify intended audience of command-line equivalents alert 2021-05-10 12:24:17 -07:00
Andrew David Wong
d1bd6881bc
Clarify vendor warning and convert to alert box
See QubesOS/qubes-issues#6591
2021-05-09 23:06:31 -07:00
Andrew David Wong
2ff7666f0a
Fix code block syntax 2021-05-08 03:01:27 -07:00
Mallory Bowes-Brown
edc9e6277f
Update installation-troubleshooting.md
Added a section for the "dracut-initqueue timeout" error message
2021-05-07 00:43:08 -05:00
Andrew David Wong
c91df0b5b7
Fix typo 2021-05-06 09:01:06 -07:00
Andrew David Wong
9eea4db0a6
Update documentation on updating Qubes OS
- Warn against using direct commands (in part due to
  QubesOS/qubes-issues#6275).
- Remove duplicate content from dom0 and domU pages. Link to main update
  page instead.
- Add information on command-line equivalents to the Qubes Update tool,
  since many Qubes users prefer to run updates via the command-line.
2021-05-06 06:34:50 -07:00
Andrew David Wong
ead482a604
Clarify that commands are executed in dom0; add user prompts 2021-05-06 06:32:46 -07:00
Andrew David Wong
163d409a78
Add dom0 update example; add --show-output to examples 2021-05-06 06:30:53 -07:00
Andrew David Wong
daba836b70
Minor text fixes 2021-04-29 15:08:56 -07:00
AJ Jordan
06a9b2bc93
Don't use "class" technical jargon in the glossary 2021-04-27 03:41:34 -04:00
Tobias Killer
a2c0565e2c
Repair broken link 2021-04-18 08:32:11 +02:00
Tobias Killer
098f5b418c
Resolve open issues mentioned on Transifex 2021-04-17 10:57:16 +02:00
Tobias Killer
617330d026
Resolve open issues mentioned on Transifex 2021-04-16 19:45:56 +02:00
Andrew David Wong
7060c4a6fa
Fix code block syntax 2021-04-15 09:07:15 -07: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
Tobias Killer
7813487b1a
Repair code block 2021-04-15 17:25:37 +02:00
Tobias Killer
e9ec3afa43
Repair link 2021-04-13 08:47:36 +02: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
d951c2d434
Delete U+200B (ZERO WIDTH SPACE) chars 2021-04-12 11:20:02 +02:00
Tobias Killer
9415119edc
Refactor links in order to obey the new convention rule 2021-04-11 01:00:19 +02:00
Tobias Killer
b6cb04c297
Refactor links in order to obey the new convention rule 2021-04-11 00:09:05 +02:00
Andrew David Wong
621f2bff47
Merge branch 'patch-1' of https://github.com/zetigu/qubes-doc into zetigu-patch-1 2021-04-06 01:18:07 -07:00
deeplow
7d4f8a079d
mention HCL reports can be submitted in the forum 2021-03-30 09:41:04 +00:00
zetigu
f794256e43
Add single line cmd to set gui-videoram-min
A bash pipe from xrandr to get total virtual screen pixels.
This will work with multiple displays and rotated display that will extend vertically the video memory usage by alot.
2021-03-29 18:20:05 -04:00
Marek Marczykowski-Górecki
752f1d4ddc
Fix over indented code blocks 2021-03-28 20:58:39 +02:00
Andrew David Wong
d328b1b1c9
Merge branch 'translation-prepare' of https://github.com/marmarek/qubes-doc into marmarek-translation-prepare 2021-03-26 20:46:10 -07:00
Andrew David Wong
3a913c861b
Merge branch 'iso-offset' 2021-03-15 15:30:44 -07:00
Andrew David Wong
fcc3f650d5
Remove unnecessary step 2021-03-15 15:14:10 -07:00
Andrew David Wong
cad8c5536a
Update user/troubleshooting/uefi-troubleshooting.md
Co-authored-by: Marek Marczykowski-Górecki <marmarek@invisiblethingslab.com>
2021-03-15 15:11:53 -07:00
Andrew David Wong
1362295f4a
Add "Qube Updates Available" image (#1119) 2021-03-15 15:10:05 -07:00
Andrew David Wong
fff68fbd62
Simplify loop device command
Clean up surrounding text and headings
2021-03-14 21:10:20 -07:00
Andrew David Wong
1392f53fa7
Add screenshot of Qubes Update tool (#1119) 2021-03-14 20:42:32 -07: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
1a92224f8b
Remove content from pages dynamically filled in by a relevant layout
In fact, right now those pages content is duplicated - once included
here and once inserted by the doc-content (or hcl) layout.
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
b8d1b4ceea
Improve Qubes Update tool documentation 2021-03-11 06:28:22 -08:00
Andrew David Wong
835a5f56be
Merge branch 'patch-9' of https://github.com/deeplow/qubes-doc into deeplow-patch-9 2021-03-11 06:17:52 -08:00
Andrew David Wong
2a418896d9
Improve dom0 backup documentation
Related: QubesOS/qubes-issues#1635
2021-03-10 22:14:59 -08:00
Andrew David Wong
71536acdfe
Merge branch 'patch-1' of https://github.com/scallyob/qubes-doc into scallyob-patch-1 2021-03-10 21:51:07 -08:00
Andrew David Wong
988577e9b2
Merge branch 'patch-1' of https://github.com/SvenSemmler/qubes-doc into SvenSemmler-patch-1 2021-03-10 21:48:42 -08:00
Andrew David Wong
906c41bd27
Generalize ISO offset instructions 2021-03-10 21:35:28 -08:00
scallyob
e8e56adc2d
Clarify Dom0 backup and restore process
Make clear that Dom0 backup only applies to /home/ and give an example of how you might try to backup system files. Also point out that any packages can/must be reinstalled on a fresh system.
2021-03-10 23:16:44 +00:00
deeplow
1c2d43069d
add placeholder 2021-03-08 14:01:45 +00:00
deeplow
c77f78d051
mention qubes updater 2021-03-08 13:27:53 +00:00
Andrew David Wong
c3ba5d522e
Document template removal warning messages
Closes QubesOS/qubes-issues#6432
2021-03-02 23:37:14 -08:00
Andrew David Wong
d71160f05d
Merge branch 'patch-1' of https://github.com/blockomat2100/qubes-doc into blockomat2100-patch-1 2021-02-28 11:15:44 -08: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
1b43ce9dfe
Update release-specific section to avoid duplication
Since release-specific notes are already included in specific news
items, avoid insinuating that such details will be provided here and
instead point to the news page.

Also link to supported versions page in EOL section, since it often
contains information pertinent to this section.
2021-02-24 16:45:21 -08:00
Andrew David Wong
2dde81e499
Remove Fedora 30 note
Fedora 30 has been unsupported for quite a long time now.
2021-02-24 16:34:00 -08:00
deeplow
1026a22442
Clarify reason for restarting templateBasedVMs
Some confusing about what this step means https://qubes-os.discourse.group/t/element-desktop/2882/3

Not sure if my commit directly clears up some of the confusing, but it may help some people understand what they have to do.
2021-02-18 17:24:38 +00:00
HackerNCoder
5701f5b733
Downgrade images to 4.0 2021-02-16 02:44:31 +01:00
Andrew David Wong
39b6f3b871
Merge branch 'hardware-troubleshooting' of https://github.com/PROTechThor/qubes-doc into PROTechThor-hardware-troubleshooting 2021-02-15 04:29:42 -08:00
unman
77ec813ab2
KDE - fix typo 2021-02-13 02:08:28 +00:00
Paul Binks
8f9514b7d1
Update windows.md
Changed 'give' to 'given'
2021-02-04 16:53:02 +00:00
Sven Semmler
b1d37d6deb
replace "apply" with close, wait, reopen
... and add link to https://www.qubes-os.org/doc/managing-appvm-shortcuts/
2021-02-01 15:12:56 -06:00
Sven Semmler
975b25f514
Add note regarding pre-existing shortcuts
Based on this discussion in the forum: https://qubes-os.discourse.group/t/reluctant-templates-for-dispvm/2639/3
2021-02-01 15:03:10 -06:00
ravachol
89053dfaf5
Update tools.md 2021-01-30 17:37:24 +01:00
Matt McCutchen
35759b4aa3
copy-paste: Discuss focus stealing 2021-01-26 23:18:04 -05:00
Marek Marczykowski-Górecki
a48402dc8b
Remove unmaintained OTP yubikey mode 2021-01-25 00:03:55 +01:00
Andrew David Wong
4002919edc
Merge branch 'usb-attach-troubleshoot-mem' of https://github.com/icequbes1/qubes-doc into icequbes1-usb-attach-troubleshoot-mem 2021-01-04 14:15:23 -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
icequbes1
e272d9cd45
Add usb troubleshooting suggestion 2021-01-02 16:09:26 -08:00
unman
16981e6ac6
Clarify treatment of user-firewall scripts 2020-12-27 16:45:01 +00:00
unman
00a657d660
Improve firewall.md, for consistent style.
Remove old material.
Clarify use of firewall scripts
2020-12-27 16:20:30 +00:00
Andrew David Wong
5ea55b1ee8
Merge branch 'feature/https-everywhere' of https://github.com/ypid/qubes-doc into ypid-feature/https-everywhere 2020-12-21 19:09:09 -08:00
Andrew David Wong
0ef818137f
Update Windows links
Closes QubesOS/qubes-issues#6296
2020-12-21 07:17:08 -08:00
Robin Schneider
ec70076361
Use HTTPS everywhere (mechanical edit using util from https-everywhere)
Ref: https://github.com/EFForg/https-everywhere/tree/master/utils/rewriter

```Shell
~/src/EFForg/https-everywhere/utils/rewriter/rewriter.js .
```
2020-12-19 19:57:07 +01:00
Andrew David Wong
c058304789
Add note on dom0 home directory restoration
Related to QubesOS/qubes-issues#2271
2020-12-18 18:09:06 -08:00
Andrew David Wong
4202598824
Remove mention of GUI software installer
Apparently, this is not option is not currently possible:
https://qubes-os.discourse.group/t/gui-only-software-installation-thoughts-fedora/1944/
2020-12-18 17:55:12 -08:00
HackerNCoder
e0e5b3337e
Change disposablevm.md to View/Edit according to 4.0/4.1 2020-12-08 15:03:30 +01:00
Andrew David Wong
5f61c3c32e
Update link to Qubes-Community version
https://github.com/QubesOS/qubes-issues/issues/4693
2020-12-07 22:54:52 -08:00
Andrew David Wong
d201a09b9a
Update links to Qubes-Community version
https://github.com/QubesOS/qubes-issues/issues/4693
2020-12-07 22:31:41 -08:00
Andrew David Wong
30e7112f4a
Convert absolute to relative links
Absolute links break automatic onion redirection:
https://groups.google.com/g/qubes-users/c/NJdzP27wvmM/
2020-12-07 17:04:29 -08:00
Andrew David Wong
795eb04d33
Merge branch 'intel-troubleshooting' of https://github.com/PROTechThor/qubes-doc into PROTechThor-intel-troubleshooting 2020-12-05 13:22:01 -08:00
Andrew David Wong
e422385ae9
Merge branch 'supported-versions-reorg' 2020-12-01 20:32:42 -08:00
Andrew David Wong
0d1dd70efd
Rephrase instructions 2020-11-29 11:25:51 -08:00
deeplow
57851be704
Explicit install commands for installing software 2020-11-29 12:33:05 +00: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
Enjeck Cleopatra
ee391c3166
Merge branch 'master' into intel-troubleshooting 2020-11-25 15:04:50 +01: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
0a27688e51
Merge branch 'update-troubleshooting' of https://github.com/PROTechThor/qubes-doc into PROTechThor-update-troubleshooting 2020-11-25 04:20:18 -08:00
Andrew David Wong
efb8195449
Merge branch 'nvidia-troubleshooting' of https://github.com/PROTechThor/qubes-doc into PROTechThor-nvidia-troubleshooting 2020-11-25 04:13:05 -08:00
Enjeck Cleopatra
3303fab5e7
Update update-troubleshooting.md 2020-11-24 20:02:32 +01: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
Andrew David Wong
a020bcfb7e
Fix variable syntax and terminology 2020-11-23 07:16:16 -08:00
Andrew David Wong
cf9da2f7d7
Merge branch 'sys-req-update' 2020-11-23 05:44:21 -08:00
Andrew David Wong
c72d05b39a
Improve document organization and text 2020-11-21 07:39:57 -08:00
Andrew David Wong
e7cc3cdb75
Merge branch 'macbook-troubleshooting' of https://github.com/PROTechThor/qubes-doc into PROTechThor-macbook-troubleshooting 2020-11-21 07:30:05 -08:00
Andrew David Wong
4398e3fe16
Update links 2020-11-21 06:59:29 -08:00
Enjeck Cleopatra
690cd14124
"qubes-usb-proxy not installed in the VM" error 2020-11-21 00:53:50 +01:00
PROTechThor
8e06262d7a Add Update Troublshooting, edit VM TS 2020-11-21 00:20:47 +01:00
Enjeck Cleopatra
265d03feb0
Merge branch 'master' into nvidia-troubleshooting 2020-11-20 16:17:03 +01:00