Commit graph

538 commits

Author SHA1 Message Date
Heiko Schaefer
f35044bd68
ch4: move certification flooding section to "advanced" part 2023-11-22 15:06:36 +01:00
Heiko Schaefer
451b881c03
ch4: new text about third-party certifications 2023-11-22 15:06:36 +01:00
Heiko Schaefer
441936eb98
ch4: new text about revocations 2023-11-22 15:06:35 +01:00
Heiko Schaefer
6f609c7f88
ch4: new text about preferences/features 2023-11-22 15:06:35 +01:00
Heiko Schaefer
c6888559f5
ch4: restructure text about metadata
Move "metadata" content into its own section.
This section started out as a remark about key flags, and was part of the "component key" section.
Generalizing it seems better, so it's now after the "linking" section, which introduces binding self-signatures.
2023-11-22 15:06:35 +01:00
Heiko Schaefer
999549dcc3
ch4: elaborate on split User IDs 2023-11-22 15:06:35 +01:00
Heiko Schaefer
fd32381839
ch8: add link anchor 2023-11-22 15:06:35 +01:00
Heiko Schaefer
886e8f5ff2
Add anchor, and clarify intended meaning of section 2023-11-22 15:06:20 +01:00
Heiko Schaefer
bf3c72d855
Adjust color description 2023-11-20 19:41:42 +01:00
David Runge
83a07f0001
Add name and alt attributes for all figures
Signed-off-by: David Runge <dave@sleepmap.de>
2023-11-20 19:13:19 +01:00
David Runge
514bb02d3d
Configure sphinx to render numbering for figures in flat hierarchy
Signed-off-by: David Runge <dave@sleepmap.de>
2023-11-20 16:24:10 +01:00
Heiko Schaefer
5cb7b94950
moved to #119 2023-11-18 17:14:53 +01:00
Heiko Schaefer
0389d75da0
ch4: drop minor redundancy 2023-11-17 14:50:37 +01:00
Heiko Schaefer
4ddbeb9e5a
use "signature packet" for disambiguation 2023-11-17 14:47:55 +01:00
Heiko Schaefer
3d02f4ae88
Fix swapped description
(From #112)
2023-11-17 14:30:05 +01:00
Heiko Schaefer
c43b444980
RNP is independent of Thunderbird 2023-11-17 13:34:18 +01:00
Heiko Schaefer
9b925ffd9c
fix list dash 2023-11-17 00:14:09 +01:00
Tammi L. Coles
5259fb0606 Merge branch 'draft' into tammi-ch6 2023-11-16 21:09:26 +00:00
Tammi L. Coles
e6c935eec9 remove 'and providing varying levels of security' 2023-11-16 22:08:05 +01:00
Heiko Schaefer
4277942114
ch8: typo fix 2023-11-16 17:31:16 +01:00
heiko
a02c7562f0 Merge branch 'draft' into tammi-heiko-ch7 2023-11-16 16:25:43 +00:00
Tammi L. Coles
1b1e918a01 add detail to ch7 pitfalls section of cleartext signatures 2023-11-16 15:16:05 +01:00
Heiko Schaefer
32b5e0cfe0
Align wording with https://gitlab.com/openpgp-wg/rfc4880bis/-/merge_requests/354/diffs 2023-11-16 13:31:10 +01:00
Tammi L. Coles
58340c97a1 edit ch7 cleartext transformations subsection 2023-11-16 11:57:46 +01:00
Tammi L. Coles
2f44224974 edit ch7 section on use case 2023-11-16 11:14:16 +01:00
Tammi L. Coles
7ed65cc02c make second-pass edits to ch7 2023-11-16 09:48:07 +01:00
Heiko Schaefer
0def7f33ae
add link anchor 2023-11-15 12:31:08 +01:00
Heiko Schaefer
c410108a67
ch8: add link anchor 2023-11-14 22:06:02 +01:00
Heiko Schaefer
d47d9fdd53
clarify 2023-11-14 19:50:30 +01:00
Heiko Schaefer
5a454e85e7
extend todo-note 2023-11-14 19:50:29 +01:00
Heiko Schaefer
77d056702a
clarity, fix typo, normalize capitalization 2023-11-14 19:28:48 +01:00
Heiko Schaefer
1e231b0f45
adjust RFC linking, minor tweaks.
I removed the "type IDs" here, because these are *packet type* IDs. The only IDs we're using in the text are *signature types*. I believe signature type IDs are the only IDs that application developers sometimes think about in numerical terms.
2023-11-14 19:28:47 +01:00
Heiko Schaefer
ad7b58ce71
clarify/tighten: there is just *one* signature packet in this paragraph. 2023-11-14 13:35:11 +01:00
Heiko Schaefer
029e517b84
removed "particularly", because for inline signatures, this issue doesn't exist at all. added the "cleartext" case, which is equivalent here. 2023-11-14 13:20:14 +01:00
Heiko Schaefer
94eb58070b
Attempt at clearer description 2023-11-14 11:33:26 +01:00
Heiko Schaefer
6db0a1f841
Merge branch 'tammi-ch7' into heiko-ch7
# Conflicts:
#	book/source/07-signing_data.md
2023-11-13 23:56:27 +01:00
Tammi L. Coles
78c8327733 edit ch7 cleartext signature 2023-11-13 22:36:05 +01:00
Tammi L. Coles
e6b9c11a3d edit ch7 inline signatures 2023-11-13 22:06:35 +01:00
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