Commit graph

601 commits

Author SHA1 Message Date
Heiko Schaefer
4f179701e3
Merge remote-tracking branch 'origin/liw-ch3-tammi' into draft
# Conflicts:
#	book/source/03-cryptography.md
2023-11-25 23:00:47 +01:00
Tammi L. Coles
f1e6da7e74 try again 2023-11-25 22:53:02 +01:00
Tammi L. Coles
90f2ad9c4f further streamline commit 7f68db756c 2023-11-25 22:15:37 +01:00
Tammi L. Coles
8ab3d359e6 edit to commit 36399d330b 2023-11-25 22:07:07 +01:00
Heiko Schaefer
11542af645
add placeholder "append-only" link target 2023-11-25 20:03:58 +01:00
Heiko Schaefer
dc9e9510d0
ci: codespell fixes 2023-11-25 20:01:26 +01:00
Heiko Schaefer
3130ebee43
Merge branch 'heiko-ch4' into draft
# Conflicts:
#	book/source/04-certificates.md
2023-11-25 19:40:56 +01:00
heiko
001f8ab343 Merge pull request 'ch4: additional edits by heiko on top of tammi's edits in heiko-ch4' (#148) from heiko-ch4-edit2 into heiko-ch4
Reviewed-on: https://codeberg.org/openpgp/notes/pulls/148
2023-11-25 18:35:27 +00:00
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
Heiko Schaefer
a9c8e138fe
add "cert-flooding" link anchor 2023-11-25 14:19:37 +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
9d040057eb Merge remote-tracking branch 'refs/remotes/origin/heiko-ch4' into heiko-ch4 2023-11-25 12:01:17 +01:00
Tammi L. Coles
50bdb0b72e edits to commit 999549dcc3 2023-11-25 11:57:39 +01:00
Tammi L. Coles
10ce55fa77 edits to #999549dcc3 2023-11-25 11:51:59 +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
heiko
a2c2beb73a Merge pull request 'Add EPUB customizations and improve CI' (#142) from dvzrv/epub_customizations into draft
Reviewed-on: https://codeberg.org/openpgp/notes/pulls/142
2023-11-24 13:02:47 +00:00
David Runge
02c7b04cfd
Adapt Containerfile to build with a patched version of sphinx
Sphinx >= 7.1.0 has issues rendering EPUBs correctly.
Install latest sphinx and apply a patch to fix EPUB rendering.

Signed-off-by: David Runge <dave@sleepmap.de>
2023-11-24 13:21:55 +01:00
David Runge
eeb1de8ab7
Add woodpecker integration for building and testing the EPUB
Signed-off-by: David Runge <dave@sleepmap.de>
2023-11-24 13:21:52 +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
57f62222d2
Add reuse config for patches
Signed-off-by: David Runge <dave@sleepmap.de>
2023-11-24 13:19:19 +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
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
Heiko Schaefer
a3cff899be
move chapters 17+ one back, insert a new "differences between versions" chapter 17 2023-11-23 12:48:18 +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