# Documentation
`doc/` documents the decisions. The [README](../README.md) is the
reference for what the commands do.
| [USER-GUIDE.md](USER-GUIDE.md) | Recipes, and the shell idioms that go with them |
| [NAMESPACES.md](NAMESPACES.md) | The `--ns` flag oxml 0.0.4 makes necessary, and does not yet exist |
| [EXIT-CODES.md](EXIT-CODES.md) | Why "no match" and "you made a mistake" are different codes |
| [ARCHITECTURE.md](ARCHITECTURE.md) | How the binary is put together |
| [SECURITY-MODEL.md](SECURITY-MODEL.md) | What it will not do to a file you point it at |
| [MIGRATION-FROM-XMLLINT.md](MIGRATION-FROM-XMLLINT.md) | Command for command |
| [TESTING.md](TESTING.md) | How the examples double as the test suite |
The oxml library's own documentation covers the parser, the tree, XPath
and the threat model in depth:
<https://github.com/sebastienrousseau/oxml/tree/main/doc>.