use myst "note" markup

This commit is contained in:
Heiko Schaefer 2023-10-12 11:28:13 +02:00
parent 62bf41b040
commit 4fb5fb4fff
No known key found for this signature in database
GPG key ID: 4A849A1904CCBD7D

View file

@ -74,7 +74,10 @@ OpenPGP was standardized in 1997 to encourage development of interoperable imple
Historically, interoperability has only been tested in an adhoc manner. Since 2019, the Sequoia project is maintaining and operating the ["OpenPGP interoperability test suite"](https://tests.sequoia-pgp.org/), for more rigorous and systematic testing. The test suite has identified numerous [issues](https://gitlab.com/sequoia-pgp/openpgp-interoperability-test-suite#hall-of-fame).
## The road ahead
> **Note:** Software and protocol development sometimes skips version numbers due to reasons like internal testing, significant changes, avoiding confusion, marketing decisions, or technical issues. The official successor to OpenPGP version 4 is OpenPGP version 6, detailed below.
```{note}
Software and protocol development sometimes skips version numbers due to reasons like internal testing, significant changes, avoiding confusion, marketing decisions, or technical issues. The official successor to OpenPGP version 4 is OpenPGP version 6, detailed below.
```
### OpenPGP version 6
@ -98,6 +101,7 @@ There is [ongoing work](https://datatracker.ietf.org/doc/draft-wussler-openpgp-p
```{admonition} TODO
Ch1 needs a "how to read this document" section and each of the Zoom-in sections needs its "you've landed here so let's explain this to you" line of some kind
```
## Zooming in: Internal structure of OpenPGP data
OpenPGP data is internally structured as "packets." We'll look into examples of this internal structure throughout the following chapters.