Commit graph

596 commits

Author SHA1 Message Date
Tammi L. Coles
50bdb0b72e edits to commit 999549dcc3 2023-11-25 11:57:39 +01:00
Tammi L. Coles
e66d5158a8 fix apostrophe format 2023-11-25 11:24:00 +01:00
Tammi L. Coles
b834628558 restore language to table, clean up structure 2023-11-25 11:19:56 +01:00
Tammi L. Coles
09efc3db67 correct CertificationRevocation section 2023-11-25 11:09:32 +01:00
Tammi L. Coles
78b2766049 correct CertificationRevocation section 2023-11-25 11:09:11 +01:00
Tammi L. Coles
8fe5dfcf33 restore language of table but fix layout 2023-11-25 11:04:59 +01:00
Tammi L. Coles
8e81ed6b36 expand note for clarity 2023-11-25 10:57:40 +01:00
Tammi L. Coles
14a95e1907 push final edits of Ch8, clarify use of italics 2023-11-25 10:56:24 +01:00
Heiko Schaefer
9e233cc011
ch5: edits 2023-11-24 20:17:04 +01:00
Heiko Schaefer
d9ebc63721
ch5: edits 2023-11-24 20:17:03 +01:00
Heiko Schaefer
5ce162b7f1
ch5: diagram notes 2023-11-24 20:17:01 +01:00
David Runge
ccddbe4204
Add local copy of upstreamed sphinx patch for CSS issues with EPUBs
The patch fixes https://github.com/sphinx-doc/sphinx/issues/11598
for sphinx >= 7.2.0

Signed-off-by: David Runge <dave@sleepmap.de>
2023-11-24 13:19:20 +01:00
David Runge
8f1d939ddb
Add make target to check a cleanly built EPUB using epubcheck
Signed-off-by: David Runge <dave@sleepmap.de>
2023-11-24 13:19:17 +01:00
David Runge
d7d34d4940
Move MyST-parser configuration to its own section
Signed-off-by: David Runge <dave@sleepmap.de>
2023-11-24 13:19:17 +01:00
David Runge
34f94f7802
Move numfig configuration to general configuration
Signed-off-by: David Runge <dave@sleepmap.de>
2023-11-24 13:19:16 +01:00
David Runge
ec761273df
Modify CSS for admonition environments when building EPUB
Add a lightgray `background-color` for all admonition environments.
Add a palevioletred `background-color` for all admonition-warning and
warning environments.

Signed-off-by: David Runge <dave@sleepmap.de>
2023-11-24 13:19:11 +01:00
Tammi L. Coles
8d4c1748c7 edit ch8 advanced section up to line 358 2023-11-23 17:39:31 +01:00
Tammi L. Coles
94abcc34f7 edit ch8 3rd party signatures 2023-11-23 16:44:21 +01:00
Tammi L. Coles
a8b17f8fe4 edit ch8 soft and hard revocations 2023-11-23 14:34:23 +01:00
Tammi L. Coles
f795da774d edit ch8 Revocation self-signatures 2023-11-23 14:24:05 +01:00
Tammi L. Coles
92948c6dda edit ch8 self-sig binding to primary ID 2023-11-23 14:14:19 +01:00
Tammi L. Coles
b4954d7a14 edit ch8 dirct key signature 2023-11-23 14:11:39 +01:00
Tammi L. Coles
92d7d218fb edit ch8 adding metadata 2023-11-23 14:09:15 +01:00
Tammi L. Coles
28a69fe381 edit ch8 binding identities 2023-11-23 14:02:13 +01:00
Tammi L. Coles
7d1d69d372 edit ch8 binding signing subkeys 2023-11-23 13:34:17 +01:00
Heiko Schaefer
7f68db756c
ch3: streamline the text that connects the "hybrid cryptosystems" concept to its use in openpgp 2023-11-23 13:31:16 +01:00
Heiko Schaefer
4e9f1c0ffd
add note to "differences between versions" chapter 2023-11-23 13:19:48 +01:00
Tammi L. Coles
d3c1634ae0 edit ch8 self-sigs in cert formation and mgmt 2023-11-23 13:12:30 +01:00
Heiko Schaefer
a3cff899be
move chapters 17+ one back, insert a new "differences between versions" chapter 17 2023-11-23 12:48:18 +01:00
Tammi L. Coles
560f75d703 edit ch8 section on distinct functions of self- v third-party sigs 2023-11-23 10:35:13 +01:00
Tammi L. Coles
2340333f40 edit signatures on components intro, self-sig v 3rd party 2023-11-23 10:16:29 +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
1331e9bb5a
mention "strong set" concept 2023-11-22 17:00:11 +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
fe8f92e99d
ch8: add link anchor 2023-11-22 16:26:25 +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
1e3672fa26
Add anchor, and clarify intended meaning of section 2023-11-22 15:06:02 +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
d7bcc75249
align link names and ordering with current chapter naming 2023-11-17 14:44:49 +01:00
Heiko Schaefer
8236e97002
typo fix 2023-11-17 14:43:35 +01:00
Heiko Schaefer
36399d330b
ch3 feedback from liw, fixes #112 2023-11-17 14:36:27 +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