589 commits

Author	SHA1	Message	Date
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
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