Commit Graph

6683 Commits

Author SHA1 Message Date
Andrew David Wong
0c048c58a0
Improve ordering, presentation, and organization of information
- Generalize "PGP key inclusion criteria" to "PGP key policies"
- Move key signing notice to new section
- Deduplicate key signing notice
- Convert bolded lines to headings
2021-07-24 11:29:34 -07:00
Andrew David Wong
9ffc1f7670
Merge branch 'zpc0-fix20210614' 2021-07-20 06:01:40 -07:00
Andrew David Wong
6fe0e40fb3
Merge branch 'fix20210614' of https://github.com/zpc0/qubes-doc into zpc0-fix20210614 2021-07-20 06:01:26 -07:00
Andrew David Wong
f442af8486
Fix link 2021-07-20 06:00:51 -07:00
Andrew David Wong
e84a92fde3
Merge branch 'verifying-sigs-secpack' 2021-07-20 04:13:31 -07:00
Andrew David Wong
0f7bc0d071
Update "Verifying signatures" and "Qubes security pack"
- Improve language
- Improve organization
- Fix typos
- Clarify steps in instructions
- Improve formatting
2021-07-20 03:47:59 -07:00
Yanase Yuki
71ae00b56f
Use docs.saltproject.io for SaltStack document
Official SaltStack repository now uses saltproject.io, so use
new domain name to avoid unnecessary redirects.

example:
https://github.com/saltstack/salt/commit/dfa0619b9e55058b
2021-07-20 19:33:09 +09:00
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
Andrew David Wong
05dcacd7b5
Revamp "Verifying signatures" and "Qubes security pack"
- Standardize syntax, formatting, and orthography
- Update links
- Clarify and improve language
- Deduplicate content
- Add info regarding keys not directly signed by the QMSK
  (https://github.com/QubesOS/qubes-doc/pull/1180#discussion_r672939404)
- Add general info about digital signature use
- Improve page organization (#1179)
- Update info and instructions regarding the QMSK
- Miscelanneous fixes and improvements
2021-07-20 02:48:23 -07:00
Andrew David Wong
39d4be00cc
Merge branch 'dksmiffs-master' 2021-07-20 02:23:52 -07:00
Andrew David Wong
abdff3c88a
Merge branch 'master' of https://github.com/dksmiffs/qubes-doc into dksmiffs-master 2021-07-20 02:23:35 -07:00
Andrew David Wong
161ef060eb
Fix headings
See https://github.com/QubesOS/qubes-doc/pull/1180#issuecomment-883103461
2021-07-19 23:15:52 -07:00
Dave Smith
b59cbe5420
Add another possible reason for "WARNING: This key is not certified...
...with a trusted signature! There is no indication that the signature
belongs to the owner."

With this edit, I'm aiming to assist the beginner reader who walked the
following breadcrumbs:

Should I trust this website?
==> verify the PGP signatures on the commits and/or tags

Detailed steps suggested by the docs along these breadcrumbs:
1) `git clone git@github.com:QubesOS/qubesos.github.io.git`
2) Verify the PGP sigs on the commits and/or tags
  a) get properly validated GPG keys (available in the Qubes Security Pack)
    i.   `git clone https://github.com/QubesOS/qubes-secpack.git`
    ii.  `gpg --import qubes-secpack/keys/*/*`
    iii. Verify/trust the QMSK (details given on the page)
  b) `cd qubesos.github.io`
  c) `git verify-commit 45ca80e8` (one of Andrew's recent commits)

RESULT: The WARNING pops up, because the user has not yet ultimately PGP
  trusted Andrew's E11D 15C6 D204 3576 9FFA  A456 8CE1 3735 2A01 9A17
  key.
2021-07-20 00:27:09 -05:00
Andrew David Wong
649babd88c
Merge branch 'dksmiffs-master' 2021-07-19 10:35:13 -07:00
deeplow
90b411720e
add bash as code-block language 2021-07-19 09:11:35 -04:00
Dave Smith
9bb30e2205
Resolve grammatical error, return to "this verification" wording (#1179) 2021-07-18 22:37:53 -05:00
Andrew David Wong
481b75761b
Add missing article 2021-07-18 18:49:58 -07:00
Dave Smith
c917f90792
Fix lost referent on "this verification" (#1179) 2021-07-17 10:29:48 -05:00
deeplow
98ca7b8f43
fix captizalization 2021-07-17 11:11:35 -04:00
deeplow
390f3eb43d
fix typo 2021-07-17 11:08:52 -04:00
deeplow
2896c019eb
Fix captization & add links 2021-07-17 11:07:59 -04: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
deeplow
d2e7232432
minor fixes 2021-07-15 06:35:45 -04:00
deeplow
715da559ce
test-bench: section on installing testing deps 2021-07-15 06:33:49 -04: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