Commit graph

251 commits

Author SHA1 Message Date
Heiko Schaefer
fbd4126a63
ch4: move misplaced text 2023-10-17 18:16:24 +02:00
Heiko Schaefer
2cdcd6aebd
ch4: adjust fingerprint in text to diagram 2023-10-17 18:15:59 +02:00
Heiko Schaefer
9d79096f24
ch4: flatten section structure
(And remove todo that was moved to ch6)
2023-10-17 18:08:42 +02:00
Heiko Schaefer
9be2dfc539
ch4: shorten "Linking" section; most of it goes to ch6 2023-10-17 17:58:26 +02:00
Heiko Schaefer
1f9f953aa6
use new diagram for ch4 2023-10-17 17:58:26 +02:00
Heiko Schaefer
5525be4c5e
update certificate diagram 2023-10-17 17:58:26 +02:00
Heiko Schaefer
a40a2654f4
a: Add link anchor for bob's key 2023-10-16 15:25:24 +02:00
Heiko Schaefer
7873c72f97
annex a: add a key for bob, with Argon2 protected Secret-Key packets 2023-10-16 15:23:56 +02:00
Heiko Schaefer
86329e757b
restructure: move "zooming in" texts from ch4 to a new chapter 17 2023-10-16 15:22:37 +02:00
Heiko Schaefer
13a3d84526
ch4: move revocations section 2023-10-16 13:20:38 +02:00
Heiko Schaefer
0965fa4fae
ch4, zooming in: remove material that involves private key
(All of that should be in ch5)
2023-10-15 14:10:21 +02:00
Heiko Schaefer
2b018c73ee
ch4: clarify that this chapter deals with "public keys" only 2023-10-15 10:56:38 +02:00
Heiko Schaefer
3ed3d5ed6a
ch4: elaborate on user id conventions 2023-10-14 22:48:55 +02:00
Heiko Schaefer
2df7aa779d
ch4: Outline how key flags are set
(addresses one point of #63)
2023-10-14 22:48:55 +02:00
Heiko Schaefer
443023b8e9
ch4: fix phrasing 2023-10-14 22:45:03 +02:00
Heiko Schaefer
13f5cd5d73
ch4: clarify text in draft user id diagram 2023-10-14 20:50:30 +02:00
Heiko Schaefer
83ccdda6b4
Terminology fixes 2023-10-12 16:07:28 +02:00
Tammi L. Coles
f0959a2b0f
Adjust
to updated RFC terminology

Fixes #52
2023-10-12 16:03:08 +02:00
Heiko Schaefer
7617d7eea6
ch4: write "user id" zooming in section 2023-10-12 14:11:21 +02:00
Heiko Schaefer
3688054f4f
ch4: restructure packet splitting text sections 2023-10-12 14:11:02 +02:00
Heiko Schaefer
1aa4696f3e
ch4: add todo notes 2023-10-12 14:11:02 +02:00
Heiko Schaefer
d1203075d1
ch4: move text into a "note" block
And add a remark that a visualization would help.
2023-10-12 14:11:02 +02:00
Heiko Schaefer
69f7eb60e5
ch4: clarify linking 2023-10-12 14:11:02 +02:00
Heiko Schaefer
bab5e427e9
ch4: add a section to talk about "no more user facing hex fingerprints in v6" 2023-10-12 14:11:02 +02:00
Heiko Schaefer
2a3605f731
ch4: move diagram up 2023-10-12 14:11:02 +02:00
Heiko Schaefer
af355ae81e
ch4: adjust markup/styling of critical flags 2023-10-12 14:11:02 +02:00
Heiko Schaefer
c1acc328d0
ch4: move "criticality" footnote into a more visible note block 2023-10-12 14:11:02 +02:00
Heiko Schaefer
a1fe545e88
ch4: add a note that the example key isn't password protected
Add link to ch5 for discussion of encrypted private key material.
2023-10-12 14:11:02 +02:00
Heiko Schaefer
134407ee2f
ch4: add a TODO note 2023-10-12 14:11:02 +02:00
Heiko Schaefer
66087b3ec9
ch4: clarify terms, use "identity components" 2023-10-12 14:11:02 +02:00
Heiko Schaefer
1f89d39740
ch4: link to glossary for "CA" 2023-10-12 14:11:02 +02:00
Heiko Schaefer
74710d804a
ch4: clarify the primary key can't confer validity beyond its own 2023-10-12 14:11:02 +02:00
Heiko Schaefer
fd2469e0e4
ch4: make links for "more on this below" pointers 2023-10-12 14:11:02 +02:00
Heiko Schaefer
8bf3440373
ch4: zooming in, write subkey sections 2023-10-12 14:11:02 +02:00
Heiko Schaefer
74e3810e84
ch4: zooming in, edits 2023-10-12 14:11:02 +02:00
Heiko Schaefer
96d9eff25f
ch4: zooming in, fix indentation of sq dump output 2023-10-12 14:11:02 +02:00
Heiko Schaefer
b1acb31ed0
ch4: zooming in, add subkey dumps 2023-10-12 14:11:02 +02:00
Heiko Schaefer
5fdb9be451
ch4: minor edits to "Seen as an OpenPGP certificate" 2023-10-12 14:11:02 +02:00
Heiko Schaefer
ac070e5229
ch4 "zooming in": fix capitalizations/styling
- Don't use quotation marks for RFC terms. Use italics, when appropriate.
- The word "packet" isn't capitalized when referring to a specific packet.
2023-10-12 14:11:02 +02:00
Heiko Schaefer
c592c6c02d
ch4: don't use title case 2023-10-12 14:11:02 +02:00
Tammi L. Coles
44eba4a6bb
change to 'may refer to' 2023-10-12 14:07:26 +02:00
Tammi L. Coles
6f179d2c07
remove asysmmetric explainer, evaluate for ch3 2023-10-12 14:07:26 +02:00
Tammi L. Coles
b353129bcc
add digital signatures 2023-10-12 14:07:26 +02:00
Tammi L. Coles
2beba67d13
edit section on layers of keys, integrating previoous Ch2 section 2023-10-12 14:07:26 +02:00
Tammi L. Coles
4e9ddaee0b
clarify in section on public vs private keys 2023-10-12 14:07:26 +02:00
Tammi L. Coles
ab926334bd
edit section intro on understanding keys 2023-10-12 14:07:26 +02:00
Tammi L. Coles
7da0131ea7
change opening lines/introduction to chapter 2023-10-12 14:07:26 +02:00
Heiko Schaefer
a0a33b13b4
ch1: notes on the elaboration 2023-10-12 12:06:53 +02:00
Heiko Schaefer
9a3bb16236
sphinx conf: more minimalistic output 2023-10-12 12:05:46 +02:00
Tammi L. Coles
f93b74638d
change to 'enable' for clarity 2023-10-12 12:01:34 +02:00
Heiko Schaefer
ea74ed2128
moved to https://codeberg.org/openpgp/notes/issues/58 2023-10-12 11:56:53 +02:00
Heiko Schaefer
b18f1eefec
moved to https://codeberg.org/openpgp/notes/issues/57 2023-10-12 11:56:18 +02:00
Heiko Schaefer
731c92d9fc
moved note into https://codeberg.org/openpgp/notes/issues/56 2023-10-12 11:50:15 +02:00
Heiko Schaefer
4fb5fb4fff
use myst "note" markup 2023-10-12 11:46:18 +02:00
Heiko Schaefer
62bf41b040
re-add (interop_section) link target 2023-10-12 11:46:18 +02:00
Tammi L. Coles
cf553aba38
edit details on PGP distribution 2023-10-12 11:46:18 +02:00
Tammi L. Coles
121119c709
clarify timeframe on v4 popularity 2023-10-12 11:46:18 +02:00
Tammi L. Coles
25f9252e48
add Bouncy Castle, remove PGPainless 2023-10-12 11:46:18 +02:00
Tammi L. Coles
250c9f42eb
insert comma 2023-10-12 11:46:18 +02:00
Tammi L. Coles
705f651a89
add s 2023-10-12 11:46:18 +02:00
Tammi L. Coles
e968ad9c75
added in 2023-10-12 11:46:18 +02:00
Tammi L. Coles
6947239101
removed extra a, changed like to such as 2023-10-12 11:46:18 +02:00
Tammi L. Coles
7fdcdb2391
edit, change to 'personally identifiable information (PII)' 2023-10-12 11:46:18 +02:00
Tammi L. Coles
e5b114a9ef
remove html in markdown 2023-10-12 11:46:18 +02:00
Tammi L. Coles
ff96d27b2e
move certificate and keys section to Ch4 2023-10-12 11:46:18 +02:00
Tammi L. Coles
f0db3cb5cc
move building blocks to Ch1 2023-10-12 11:46:18 +02:00
Tammi L. Coles
9ff8b69cb7
move high-level operations to Ch1 2023-10-12 11:46:18 +02:00
Tammi L. Coles
c65141a712
clarify why there is no v5 2023-10-12 11:46:18 +02:00
Tammi L. Coles
8e8507ebbf
add note regarding zoom in intructions 2023-10-12 11:46:18 +02:00
Tammi L. Coles
9ba166f4df
remove (interop_section)= line 2023-10-12 11:46:18 +02:00
Tammi L. Coles
b39d808290
move interoperability section 2023-10-12 11:46:18 +02:00
Tammi L. Coles
a8c14033a7
correct typo 2023-10-12 11:46:18 +02:00
Tammi L. Coles
02603ef7db
correct typo 2023-10-12 11:46:18 +02:00
Tammi L. Coles
bfb34f8f6b
change header on implementations 2023-10-12 11:46:18 +02:00
Tammi L. Coles
5b5e449925
note that an issue needs to be created re v5 2023-10-12 11:46:18 +02:00
Tammi L. Coles
b3338bb4e2
note that an issue needs to be created re OpenPGP line 2023-10-12 11:46:18 +02:00
Tammi L. Coles
985f29d4c7
fix punctuation 2023-10-12 11:46:18 +02:00
Tammi L. Coles
3c75ccc3c5
edit certificates and keys concept section 2023-10-12 11:46:18 +02:00
Tammi L. Coles
5077358a99
add line breaks for legibility 2023-10-12 11:46:18 +02:00
Tammi L. Coles
fb0b47d4f4
add line breaks for legibility 2023-10-12 11:46:18 +02:00
Tammi L. Coles
9b81ebb8fe
improve text re version 6 2023-10-12 11:46:18 +02:00
Tammi L. Coles
9ef56526bc
improve text re version 4 and its implementations 2023-10-12 11:46:18 +02:00
Tammi L. Coles
7a0b4832ec
edit history to of PGP, standardizing, and GnuPG 2023-10-12 11:46:18 +02:00
Tammi L. Coles
6679f2fdf9
edit language and punctuation of PGP line 2023-10-12 11:46:18 +02:00
Tammi L. Coles
e103ac0797
expand "why OpenPGP" section 2023-10-12 11:46:18 +02:00
Tammi L. Coles
797ff78719 Merge pull request 'ch1: high level text moved here (formerly from ch2)' (#44) from tammi-ch1 into draft
Reviewed-on: https://codeberg.org/openpgp/notes/pulls/44
2023-10-12 09:43:26 +00:00
Heiko Schaefer
b1dab566a8
ch3: move terminology note into an
"admonition"
2023-10-09 18:04:54 +02:00
Tammi L. Coles
3f8fb4690f change format to standard and clarify role 2023-10-07 14:12:45 +02:00
Tammi L. Coles
6a22002cb8 remove unnecessary line breaks 2023-10-07 13:34:50 +02:00
Tammi L. Coles
67bdc2f64b integrate operations & building blocks statements formerly in Ch2 2023-10-07 13:29:31 +02:00
Heiko Schaefer
7e760f2035
ch4: minor edits 2023-10-05 10:33:42 +02:00
Heiko Schaefer
c657d64734
ch4: improvements to "zooming in" 2023-10-05 10:33:42 +02:00
Heiko Schaefer
ec78df2453
ch4: clarify terminology
Also see #43
2023-10-05 10:30:35 +02:00
Heiko Schaefer
d20fbbc13d
ch3: processed feedback from wiktor 2023-10-04 21:21:04 +02:00
Heiko Schaefer
305f039dff
ch4: feedback from wiktor 2023-10-04 18:40:02 +02:00
Heiko Schaefer
810cec05e2
ch2: feedback from david 2023-10-04 16:25:04 +02:00
Heiko Schaefer
8ca953e39e
diag: Use png versions of diagrams for now
In the epub version, some viewers don't show text for svg diagrams (probably a missing font issue).
2023-10-04 16:25:04 +02:00
Heiko Schaefer
0368edef16
ch4: flesh out first part of "zooming in" section 2023-10-04 15:37:39 +02:00
Heiko Schaefer
0a41338801
ch4: simplify "note" markup 2023-10-04 15:35:46 +02:00
Heiko Schaefer
c1e6630f9f
ch10/11: outline adjustments
Move legacy "SED" mode from "encrypt" to "decrypt" chapter
2023-10-04 15:19:12 +02:00