panproto
panproto compares schema versions, constructs migrations, and applies those migrations to data. Your first diff introduces that workflow with two ATProto Lexicon documents and the structural diff between them.
Choose a path
Choose a path based on the work you need to do:
| Experience | Start here | Continue with |
|---|---|---|
| New to panproto | Your first diff | Your first schema, then Your first migration |
| Adding panproto to a project | Install | Define a schema, build a migration, then add a breaking-change gate |
| Designing protocols or extending the system | Build a custom protocol | Find schema spans, study the architecture, then consult the denotational semantics |
The vocabulary in plain terms introduces unfamiliar terms. The glossary records their reference definitions.
Find the kind of answer you need
The book follows the four-part Diátaxis structure:
| Section | Use it when | What you will find |
|---|---|---|
| Tutorials | You are learning by doing | Guided sequences |
| How-to guides | You have a specific task | Procedures, verification steps, and common failures |
| Reference | You need an exact contract | Commands, signatures, configuration fields, and supported surfaces |
| Explanation | You need the reason or the model | Design arguments, categorical constructions, architecture, and semantics |
Begin with a tutorial if you need both context and a worked sequence. Use reference pages when you already know the operation and need its exact contract.