487 commits

Author	SHA1	Message	Date
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
Tammi L. Coles	43faca00e3	correct for hash digest, move reference	2023-11-02 13:44:28 +01:00
Tammi L. Coles	00270a07e5	remove extra space	2023-11-02 13:07:45 +01:00
Tammi L. Coles	e20658c249	resolve https://codeberg.org/openpgp/notes/pulls/91#issuecomment-1310156	2023-11-02 12:46:02 +01:00
Tammi L. Coles	a6516a949c	resolve https://codeberg.org/openpgp/notes/pulls/91#issuecomment-1305908	2023-11-02 12:38:25 +01:00
Tammi L. Coles	d37382d43d	Merge branch 'draft' into tammi-ch17	2023-11-02 10:42:41 +00:00
Tammi L. Coles	33cab7b59a	change period to colon	2023-11-02 10:17:49 +01:00
Heiko Schaefer	ed7ab4760f	ch6: Use new diagram	2023-11-01 21:40:49 +01:00
Heiko Schaefer	5b0eb1948a	Import new diagrams	2023-11-01 21:34:51 +01:00
Heiko Schaefer	77c901889b	Terminology fix	2023-10-30 00:28:43 +01:00
Heiko Schaefer	1dbe95cb1f	fix link names	2023-10-29 23:47:36 +01:00
Heiko Schaefer	bedae03c42	fix todo admonition syntax	2023-10-29 23:36:35 +01:00
Heiko Schaefer	b257e9a366	moved "VISUAL" admonitions to #95 ... we should consider if we want such diagrams after the core writing phase (if we have time).	2023-10-29 23:14:32 +01:00
Heiko Schaefer	d44226d288	ch5: use new diagrams	2023-10-29 23:07:51 +01:00