Commit Graph

6391 Commits

Author SHA1 Message Date
Dave Smith
c917f90792
Fix lost referent on "this verification" (#1179) 2021-07-17 10:29:48 -05:00
Dave Smith
a0b355b0c5
Move 'properly validated keys' guidance before git verification...
...in the "How to Verify Qubes Repos" section, since you must have
properly validated keys before being able to perform a successful
`git verify-tag` or `git verify-commit`.
2021-07-16 21:02:37 -05:00
Andrew David Wong
4de71b367d
Merge branch 'dksmiffs-master' 2021-07-16 13:37:30 -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
392c994914
Merge branch 'dksmiffs-master' 2021-07-14 10:46:13 -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
6eea2bf394
Fix typo 2021-07-10 15:03:56 -07:00
Andrew David Wong
e89bc971ae
Update terminology 2021-07-10 14:47:15 -07: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
a1967f09ad
Fix typo 2021-07-10 14:19:45 -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
ef3440228f
Cross-link doc style guide and how-to pages 2021-07-10 13:49:27 -07:00
Andrew David Wong
b9bf32e6f8
Add section on serving website locally 2021-07-10 13:19:24 -07:00
Andrew David Wong
6de3d7f75f
Fix typo 2021-07-10 13:16:07 -07:00
Andrew David Wong
473f1075c8
Update example to reflect current style guide 2021-07-10 13:08:13 -07:00
Andrew David Wong
f608865417
Update doc style guide and instructions
- Explain why image linking is important
- Improve wording
- Fix link
- Minor improvements
2021-07-10 12:52:48 -07:00
Andrew David Wong
ce900bfea7
Merge branch 'deeplow-patch-23' 2021-07-10 12:50:23 -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
f0a0fd36fe
Merge branch 'unman-6769' (closes QubesOS/qubes-issues#6769) 2021-07-10 11:30:58 -07:00
Andrew David Wong
294e433b3d
Remove note about QubesOS/qubes-issues#6769 (fixed) 2021-07-09 05:19:05 -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
Andrew David Wong
ad2c60d91d
Merge branch '6769' of https://github.com/unman/qubes-doc into unman-6769 2021-07-09 04:23:31 -07:00
unman
d0bc9e70a2
Sentence case for titles 2021-07-09 01:06:41 +00:00
Andrew David Wong
e09d2d4c7a
Use shorter anchor text for doc index link 2021-07-08 10:17:34 -07:00
Andrew David Wong
bc5276a290
Improve section organization, formatting; fix link 2021-07-08 10:14:31 -07:00
Andrew David Wong
a867dbe06a
Add note about QubesOS/qubes-issues#6769 2021-07-08 08:24:13 -07:00
Andrew David Wong
d9ce14a1d0
Rename files in accordance with commit 676a13b 2021-07-08 08:09:41 -07: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
Andrew David Wong
c4f59952f5
Merge branch 'deeplow-patch-22' 2021-07-06 07:14:25 -07:00
Andrew David Wong
eca8b6fb05
Merge branch 'patch-22' of https://github.com/deeplow/qubes-doc into deeplow-patch-22 2021-07-06 07:12:27 -07:00
Andrew David Wong
321ee9dedc
Merge branch 'gw0-patch-1' 2021-07-06 06:45:21 -07:00
Andrew David Wong
ecd72e6a9b
Merge branch 'patch-1' of https://github.com/gw0/qubes-doc into gw0-patch-1 2021-07-06 06:44:47 -07:00
Andrew David Wong
07da69bc0e
Revamp "Documentation Guidelines"
- Update contribution steps and first two images
- Improve source formatting and consistency
- Add information
- Improve organization and add subheadings
- Clarify and improve wording
2021-07-06 06:25:33 -07:00