# Documentation

| Directory      | Contents                                      |
|----------------|-----------------------------------------------|
| `spec/`        | Formal ISA specification reference manual     |
| `manual/`      | Programmer's guide — assembly, toolchain use  |
| `abi/`         | Application Binary Interface specification    |
| `internals/`   | Microarchitecture, pipeline, implementor notes|
| `examples/`    | Annotated code examples in asm/C              |

The `gen/docs/` generator produces source files for these docs from the
machine-readable ISA definitions.