Commit graph

500 commits

Author SHA1 Message Date
Tammi L. Coles
17d43e0e91 edit ch7 inline signatures 2023-11-13 21:33:03 +01:00
Tammi L. Coles
62af0cb83b edit ch7 detached signatures 2023-11-13 21:27:37 +01:00
Tammi L. Coles
ee65b80bc7 default to data signatures not signature over data 2023-11-13 21:20:09 +01:00
Tammi L. Coles
7e89a9f11f remove blank line 2023-11-13 21:18:15 +01:00
Tammi L. Coles
a76acf950b edits to data signature forms 2023-11-13 20:57:56 +01:00
Tammi L. Coles
f0052e23c2 edits to data signature forms 2023-11-13 20:57:44 +01:00
Heiko Schaefer
42eb52e95c
ch8: some more text about delegating trust and WoT 2023-11-13 20:52:08 +01:00
Heiko Schaefer
6812b29d23
ch8: third-party signatures 2023-11-13 01:29:44 +01:00
Heiko Schaefer
61d664f0b0
ch8: edit and expand "revocations" section 2023-11-13 01:29:44 +01:00
Heiko Schaefer
2346c346c2
ch8: edits for clarity and flow 2023-11-13 01:29:44 +01:00
Heiko Schaefer
06da358f99
ch8: write missing "signatures for primary key metadata" section 2023-11-13 01:29:44 +01:00
Heiko Schaefer
6bbef95d21
ch4: add todo 2023-11-13 01:29:37 +01:00
Heiko Schaefer
7706df1cc9
ch4: fix typos 2023-11-13 01:28:11 +01:00
Heiko Schaefer
1c3a693442
minor editing fix 2023-11-12 00:44:54 +01:00
Heiko Schaefer
1c8d728612
revert accidental removal of Fingerprint diagram 2023-11-12 00:18:30 +01:00
Heiko Schaefer
6dc243de98
ch7: Write "transformations" section about CSF 2023-11-11 21:05:01 +01:00
Heiko Schaefer
1b5edc1774
ch7: clarify CSF and its use 2023-11-11 21:05:01 +01:00
Tammi L. Coles
4fd97868e8 edit ch7 forms of data signatures 2023-11-10 17:53:52 +01:00
Tammi L. Coles
f7ea1b115e edit ch7 ## Signature types 2023-11-10 17:45:36 +01:00
Tammi L. Coles
51ba919106 edit ch7 signatures over data 2023-11-10 17:28:26 +01:00
Tammi L. Coles
8a82cebd6c edit ch6 notation subpackets with the Keyoxide example 2023-11-10 16:48:25 +01:00
Tammi L. Coles
44a4a00a2e edit ch6 "Criticality of subpackets" 2023-11-10 16:30:07 +01:00
Tammi L. Coles
93d061efc7 remove another random colon :D 2023-11-10 15:57:47 +01:00
Tammi L. Coles
48f39f0ffb remove colon from subheader 2023-11-10 15:57:07 +01:00
Tammi L. Coles
ec61e782df edit ch6 hashed vs unhashed areas 2023-11-10 15:56:22 +01:00
Tammi L. Coles
18a621c827 edit on ch6 verifying packet section and subpackets 2023-11-10 15:41:11 +01:00
Tammi L. Coles
3dcc962c57 edit on ch6 verifying packet section 2023-11-10 15:21:22 +01:00
Tammi L. Coles
3b401a17a7 tighten up ch6 signature packet creation section 2023-11-10 15:07:35 +01:00
Tammi L. Coles
d4a616094e restructure signature packet section of ch6 2023-11-10 14:45:39 +01:00
Heiko Schaefer
2445b2f414
ch7: edits for clarity 2023-11-10 01:59:20 +01:00
Heiko Schaefer
7f9aba28fa
restructure text blocks 2023-11-09 01:43:56 +01:00
Heiko Schaefer
420e15e8c8
remove seemingly stray text 2023-11-08 21:01:29 +01:00
Heiko Schaefer
1335d5568f
edits 2023-11-08 21:01:28 +01:00
Heiko Schaefer
b73789d1c8
adjust structure 2023-11-08 21:00:29 +01:00
Heiko Schaefer
0039afd7fd
edits 2023-11-08 21:00:29 +01:00
Tammi L. Coles
e20a629db7 edit signature types section in Ch6 2023-11-07 21:33:19 +01:00
Tammi L. Coles
2ee0d7263a edits on Ch6 terminology 2023-11-07 21:16:08 +01:00
Tammi L. Coles
e23fd3de9c tighten text of signatures intro section 2023-11-07 20:58:28 +01:00
Heiko Schaefer
bf41637c05
Restructure opening 2023-11-07 14:34:02 +01:00
Heiko Schaefer
390089139e
remove todo text 2023-11-06 23:25:29 +01:00
Heiko Schaefer
169ce620e9
Experiment: Adjust signature type diagram structure 2023-11-06 23:21:18 +01:00
Heiko Schaefer
658b03b1a4
Edits (in part based on feedback from David) 2023-11-06 13:45:50 +01:00
Heiko Schaefer
d1e23fef9e
Add new signature diagrams. Add some more text and structure for them. 2023-11-06 00:55:46 +01:00
Heiko Schaefer
1dc7a7f116
update image 2023-11-05 21:46:36 +01:00
Heiko Schaefer
366bb70b54
import new/updated diagrams from skvis-draft 2023-11-05 21:26:35 +01:00
skvisual
7326a765ad
import new/updated diagrams from skvis-draft 2023-11-05 21:20:52 +01:00
Heiko Schaefer
256c9b14e8
ch19: add link target 2023-11-05 20:56:05 +01:00
Heiko Schaefer
10246eebc1
Drop duplicate diagram files 2023-11-04 19:09:19 +01:00
Heiko Schaefer
c05cd64f7f
Drop many of the legacy diagrams 2023-11-04 19:06:40 +01:00
Heiko Schaefer
e1668dbd09
Add a bit of text about where the "backsig" is actually embedded 2023-11-04 18:39:18 +01:00
Heiko Schaefer
f91b386ea9
Edits based on David's input 2023-11-03 18:51:12 +01:00
Heiko Schaefer
4754753cfc
Elaborate how the signature is calculated 2023-11-03 18:51:12 +01:00
Heiko Schaefer
384f26c1bc
David says the signature type diagram is confusing, maybe it needs more explanation?
I suppose the (at least) 2x2 Matrix of types of component signatures is hard to make sense of, and hard to visualize.
2023-11-03 18:51:12 +01:00
Heiko Schaefer
4d8ade3502
Add diagram for signature packet structure 2023-11-03 18:51:12 +01:00
Heiko Schaefer
e814cc5bb1
tmp: placeholder images, waiting for replacements in skvis-draft 2023-11-03 18:51:12 +01:00
Heiko Schaefer
1ec7d9a2ea
David points out that "magic" can be read as intimidating.
Like a topic is very hard to understand, or only accessible to wizards.
2023-11-03 18:51:12 +01:00
Tammi L. Coles
bac6fbe6fd clause correction in 69f5bce965 2023-11-03 12:31:21 +01:00
Heiko Schaefer
5e97344039
fix link target name 2023-11-03 12:26:06 +01:00
Heiko Schaefer
d33c8d7933
ch3: sharpen our terminology, use "hash digest" by default
Fixes #98
2023-11-03 12:25:50 +01:00
Heiko Schaefer
40924bef0d
Slightly expand/clarify phrasing on quantum resistance 2023-11-03 12:25:50 +01:00
Tammi L. Coles
8bb4baeff7 change verb in ef7a9956e4 2023-11-03 12:20:58 +01:00
Tammi L. Coles
661beb75e4 correct spelling in be01588cce 2023-11-03 12:18:34 +01:00
Tammi L. Coles
94ef48bdee edit 3ca2bc5529 2023-11-03 12:16:27 +01:00
Heiko Schaefer
f6bcc53211
Fix tense 2023-11-03 12:04:05 +01:00
Heiko Schaefer
75ac101a40
Introduce terms: confidentiality and authenticity 2023-11-03 12:04:05 +01:00
Heiko Schaefer
53473b025c
Remove redundancy 2023-11-03 12:04:04 +01:00
Heiko Schaefer
22b05ed942
Motivation text for this document 2023-11-03 12:04:04 +01:00
Heiko Schaefer
a3cf766492
Reorder text 2023-11-03 12:04:04 +01:00
Tammi L. Coles
139a543db2 resolve https://codeberg.org/openpgp/notes/pulls/104#issuecomment-1318049 2023-11-03 11:59:37 +01:00
Heiko Schaefer
080c88909b
Cut redundancy 2023-11-03 11:53:34 +01:00
Heiko Schaefer
e4631e2b23
"Zooming in" content was moved to chapters at the end of the book 2023-11-03 11:53:34 +01:00
Heiko Schaefer
5eb6d310cf
Fix version claims and add a bit more detail about extensions to 4880.
It's not so straightforward: RFC 2440 and 4880 both define OpenPGP version 4 artifacts. So naming versions in the text is tricky.
2023-11-03 11:53:34 +01:00
Heiko Schaefer
1c9b9d8724
Remove stray brace 2023-11-03 11:53:34 +01:00
Heiko Schaefer
31d64fdb37
Fix link syntax 2023-11-03 11:53:34 +01:00
Heiko Schaefer
5f41b4fe64
update link to component_signatures_chapter 2023-11-03 10:56:05 +01:00
Heiko Schaefer
8704758dde
Merge branch 'draft' into tammi-ch4
# Conflicts:
#	book/source/04-certificates.md
2023-11-03 10:43:58 +01:00
Tammi L. Coles
8fc4302338 resolve https://codeberg.org/openpgp/notes/pulls/81#issuecomment-1317436 2023-11-03 10:35:36 +01:00
Tammi L. Coles
783b151af6 Resolve https://codeberg.org/openpgp/notes/pulls/81#issuecomment-1291286 2023-11-03 10:20:20 +01:00
Tammi L. Coles
acb1d9f7e1 Resolve https://codeberg.org/openpgp/notes/pulls/81#issuecomment-1291281 2023-11-03 10:16:00 +01:00
Tammi L. Coles
86ce3d8ce2 change to bind to resolve https://codeberg.org/openpgp/notes/pulls/81#issuecomment-1291278 2023-11-03 10:15:16 +01:00
Tammi L. Coles
969fde83b2 change often to typically to resolve https://codeberg.org/openpgp/notes/pulls/81#issuecomment-1291271 2023-11-03 10:14:19 +01:00
Tammi L. Coles
0febf20d24 correct that fingerprint is not unique to resolve https://codeberg.org/openpgp/notes/pulls/81#issuecomment-1291270 2023-11-03 10:10:36 +01:00
Tammi L. Coles
accdb48301 clarify distinct role of primary key to resolve https://codeberg.org/openpgp/notes/pulls/81#issuecomment-1291268 2023-11-03 10:08:55 +01:00
Heiko Schaefer
c563f8a891
Generate updated png (with spelling fix, but for some reason this time with white background 🤷) 2023-11-02 20:07:00 +01:00
Heiko Schaefer
8f5d9f48a1
Add a note that diagram spelling should not be fixed.
We'll fix diagram spellings in the course of the merge into the future 'main' branch.
2023-11-02 19:51:32 +01:00
David Runge
32a05d2c5b
Remove bat based Make file for Windows as it is unused
Signed-off-by: David Runge <dave@sleepmap.de>
2023-11-02 19:05:10 +01:00
David Runge
82f59746f2
Add codespell integration, which checks all sources
Add a make target for running `codespell` on all sources.
Skip running codespell on the build directory (we have javascript etc.
in there).
Only emit warnings but do not fail on spelling errors in diagrams.

Signed-off-by: David Runge <dave@sleepmap.de>
2023-11-02 19:05:05 +01:00
David Runge
cb4ac38e05
Fix spelling in source files
Signed-off-by: David Runge <dave@sleepmap.de>
2023-11-02 18:41:36 +01:00
Tammi L. Coles
dde0eae900 spell out the "not unique" issue to resolve https://codeberg.org/openpgp/notes/pulls/81#issuecomment-1291244 2023-11-02 17:52:35 +01:00
Tammi L. Coles
6d9bf44ba5 change fingerprint language to resolve https://codeberg.org/openpgp/notes/pulls/81#issuecomment-1291232 2023-11-02 17:46:55 +01:00
Tammi L. Coles
4d695764d0 connect metadata paragraphs better to resolve https://codeberg.org/openpgp/notes/pulls/81#issuecomment-1291216 2023-11-02 17:42:27 +01:00
Tammi L. Coles
e878c637b8 edit 118 to resolve https://codeberg.org/openpgp/notes/pulls/81#issuecomment-1291275 2023-11-02 17:31:14 +01:00
David Runge
e13127e064
When link checking, always build HTML from scratch
To be on the safe side, always build HTML pages from scratch, so that
lychee checks the actual current version of the files.

Signed-off-by: David Runge <dave@sleepmap.de>
2023-11-02 16:46:18 +01:00
David Runge
c9e7b03f53
Fail on warnings when building with sphinx-build
Fixes https://codeberg.org/openpgp/notes/issues/90

Signed-off-by: David Runge <dave@sleepmap.de>
2023-11-02 16:46:18 +01:00
David Runge
5fd9676392
Add a file to keep the static dir around when cloning the repo
Signed-off-by: David Runge <dave@sleepmap.de>
2023-11-02 16:46:17 +01:00
David Runge
415fb44ace
Do not fail on footnotes directly following a heading
Signed-off-by: David Runge <dave@sleepmap.de>
2023-11-02 16:46:16 +01:00
David Runge
a88e3023a8
Move 06-terminology.md to a temporary location
As mermaid pulls in many dependencies and is not setup in CI,
sphinx-build will fail on trying to render the file.

Signed-off-by: David Runge <dave@sleepmap.de>
2023-11-02 16:46:15 +01:00
Heiko Schaefer
3e64c68f92
use direct link (link checks in codeberg CI are currently failing for the archive.org link) 2023-11-02 14:55:25 +01:00
Heiko Schaefer
2a5667062e
ch17: use public key and direct key signature packet diagrams 2023-11-02 13:54:39 +01:00
Tammi L. Coles
333a8862ac change to calculated 2023-11-02 13:47:20 +01:00