Commit graph

238 commits

Author SHA1 Message Date
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
Heiko Schaefer
061f4a9625
ch2: add section about PQC work; move "zooming in" to the end 2023-10-04 14:55:40 +02:00
Heiko Schaefer
ee35f4af51
ch4: remove duplication 2023-10-04 14:33:41 +02:00
Heiko Schaefer
f62fb72190
ch3: drop task (it's done) 2023-10-04 14:33:40 +02:00
Heiko Schaefer
664f3cec86
conf: enable show_relbars
fixes #40
2023-10-04 14:01:51 +02:00
Heiko Schaefer
55d1ce73a1
ch3: improvements suggested by @vanitasvitae
fixes #34
2023-10-04 10:56:10 +02:00
Heiko Schaefer
a59190bf4b
diag: new component key diagram 2023-10-03 20:39:05 +02:00
Heiko Schaefer
724a0673fd
fix/normalize "zooming in" section titles 2023-10-03 20:08:02 +02:00
Heiko Schaefer
cc6077e27c
ch4: use new diagrams 2023-10-03 19:34:48 +02:00
Heiko Schaefer
1f18e9a8ff
ch4: Edit main part of the text 2023-10-03 19:34:48 +02:00
Heiko Schaefer
ea7dc03e46
diag: backsig 2023-10-03 19:34:48 +02:00
Heiko Schaefer
59e292a3ec
diag: clarify metadata 2023-10-03 19:34:48 +02:00
Heiko Schaefer
0cbc17840e
diag: clarify metadata in component keys 2023-10-03 19:34:48 +02:00
Heiko Schaefer
d69617afbd
Appendix A: adjust chapter name
This name is shown when linking to (alice_priv) and not providing a link text.
2023-10-03 19:34:48 +02:00