Heiko Schaefer
5f694e8c23
clarification: "append" implies "stored at the end of a file." this is not generally true for these two cases.
...
I now realize that this is weird: we're claiming that certificates are "append only". However, the meaning of that term, in OpenPGP is ... not about the location of additions. Rather it just means "we only get to add packets, not remove them". Regardless of packet order.
2023-11-25 15:11:17 +01:00
Heiko Schaefer
5faec16cb8
Improve on original text: "Elements" encompass both "components" and "signatures." Regarding malicious addition, we care about both.
...
Additionally, "typically" reads confusingly weak to me, erring on the side of "maybe too strong" with "will" seems better.
2023-11-25 14:56:17 +01:00
Heiko Schaefer
97e413a3dd
in our text, this fingerprint represents Alice's certificate (and isn't an example)
2023-11-25 14:53:00 +01:00
Heiko Schaefer
cdbf15e49a
clarify how the back signature is embedded
2023-11-25 14:47:34 +01:00
Heiko Schaefer
a9c8e138fe
add "cert-flooding" link anchor
2023-11-25 14:19:37 +01:00
Heiko Schaefer
e05f104974
clarify enumeration of legitimate unbound packets
...
This is supposed to be a list of legitimate uses. I've removed the elaboration of the flooding problem, and replaced it with a link to an elaboration in ch4.
2023-11-25 14:16:30 +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
Heiko Schaefer
2580ae317d
typo fix
2023-11-25 13:06:08 +01:00
Heiko Schaefer
1a4ef8a975
clarify: the flag is not always set
2023-11-25 13:04:58 +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
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
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
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
