Commit graph

526 commits

Author SHA1 Message Date
Heiko Schaefer
5621dfa79c
avoid using the technical term "key" as a generic word 2023-11-25 19:29:18 +01:00
Heiko Schaefer
b121676a0d
i think "demonstrate" gestures partly in the wrong direction.
much agility is already built in. the point here is not that more agility can be built in on short notice (even though that is also true). but rather that OpenPGP already allows users to make a lot of decisions about which mechanisms to use, right now.
2023-11-25 19:26:55 +01:00
Heiko Schaefer
0a2bccb380
generalize: User Attributes are uncommon, but we should include them 2023-11-25 19:20:42 +01:00
Heiko Schaefer
ee1e9d5396
simplify/clarify section title 2023-11-25 19:20:00 +01:00
Heiko Schaefer
4635d15ece
drop duplication 2023-11-25 18:41:35 +01:00
Heiko Schaefer
111f6cca41
attempt at footnote with more detail on fingerprint uniqueness. the exact content might need more tweaking. 2023-11-25 18:39:02 +01:00
Heiko Schaefer
a431853832
zoom_certificates doesn't talk about private keys (anymore). de-emphasize the packet-level chapter (it's still very unclear to me how many readers should look at those chapters). 2023-11-25 18:24:36 +01:00
Heiko Schaefer
3b0dfd5cd7
move contextualization paragraphs up to the first block 2023-11-25 18:14:45 +01:00
Tammi L. Coles
8c8cf2ed50 edit commit 02b0785584 on the not-exactly-unique fingerprint 2023-11-25 16:30:54 +01:00
Tammi L. Coles
4a2595c5f7 remove comma in commit e0457bac64 2023-11-25 16:24:09 +01:00
Tammi L. Coles
f0e5c00803 reorganize and structure content to answer commit 992c878fea 2023-11-25 16:17:31 +01:00
Tammi L. Coles
7cb536008b edit commit 451b881c03 2023-11-25 16:03:52 +01:00
Tammi L. Coles
018a6107c1 edit to commit 441936eb98 2023-11-25 15:33:34 +01:00
Tammi L. Coles
d49cf0b713 Edit commit 6f609c7f88 2023-11-25 14:12:09 +01:00
Tammi L. Coles
a914e60fa3 edit metadata capabilities of commit c6888559f5 2023-11-25 13:59:35 +01:00
Tammi L. Coles
6ada412e74 clarify auth-flag of commit c6888559f5 2023-11-25 13:42:41 +01:00
Tammi L. Coles
50bdb0b72e edits to commit 999549dcc3 2023-11-25 11:57:39 +01:00
Heiko Schaefer
02b0785584
ch4: attempt at clarifying the kind-of-unique-but-technically-not property of fingerprints, to deal with #113 2023-11-22 21:38:33 +01:00
Heiko Schaefer
b337068d61
ch4: process input from liw, in #113 2023-11-22 21:08:22 +01:00
Heiko Schaefer
7f90c71be4
ch4: clarification 2023-11-22 17:49:08 +01:00
Heiko Schaefer
28ec86b4b6
ch4: fix flow/logic 2023-11-22 17:36:31 +01:00
Heiko Schaefer
fc665cb197
ch4: clarification as suggested by wiktor 2023-11-22 17:34:53 +01:00
Heiko Schaefer
e0457bac64
ch4: clarify that user attribute images are JPEG 2023-11-22 17:24:29 +01:00
Heiko Schaefer
142250277f
ch4: qualify split user id section with a footnote linking to dkg's 2019 blog outlining problems 2023-11-22 17:18:51 +01:00
Heiko Schaefer
c575165cd3
ch4: clarify/link "certificates are effectively append-only" 2023-11-22 17:09:14 +01:00
Heiko Schaefer
6757b47f81
ch4: minor edits 2023-11-22 17:03:55 +01:00
Heiko Schaefer
166ab7bc55
mention "wot" and link to ch8 section 2023-11-22 16:54:59 +01:00
Heiko Schaefer
2f4a794d1c
ch8: add link anchor 2023-11-22 16:29:26 +01:00
Heiko Schaefer
4a39b20586
ch4: clarify primary user id section 2023-11-22 15:23:20 +01:00
Heiko Schaefer
ae2c732730
Note that DKS is preferred in v6 2023-11-22 15:06:38 +01:00
Heiko Schaefer
ade8edd697
link to cryptographic hashes 2023-11-22 15:06:38 +01:00
Heiko Schaefer
42b9e98e21
clarify that "authentication" key flag is not about validating user ids 2023-11-22 15:06:37 +01:00
Heiko Schaefer
ff198a3413
Clarify authentication key flag 2023-11-22 15:06:37 +01:00
Heiko Schaefer
992c878fea
This phrasing feels less confusing to me.
I think this paragraph needs some more sharpening, but am still unsure about exactly how.
2023-11-22 15:06:37 +01:00
Heiko Schaefer
1156d4987e
adjust User ID diagram description 2023-11-22 15:06:37 +01:00
Heiko Schaefer
15af2240ac
ch4: minor edits from wiktor feedback 2023-11-22 15:06:37 +01:00
Heiko Schaefer
26df966a2c
clarify metadata section 2023-11-22 15:06:36 +01:00
Heiko Schaefer
d157a4d1fc
move todo into advanced section branch, add link 2023-11-22 15:06:36 +01:00
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