# Documentation
These files describe bomalloc 0.3.1 as currently implemented.
## User and integration documentation
- [Current design](design-status.md): architecture, ownership semantics,
concurrency boundaries, reclamation, and limitations.
- [Rust global allocator API](global-allocator-api.md): `BoGlobalAllocator`,
initialization, bootstrap, shutdown, and safety contracts.
- [C ABI](c-abi.md): exported API, linking, layouts, versioning, and cross-thread
behavior.
## Current performance evidence
- [Mature allocator benchmark](mature-benchmark-results.md): current Windows and
Linux external workload comparison.
- [Runtime-shaped workloads](runtime-workload-results.md): service ownership
transfer and generational runtime experiments.
Historical implementation checkpoints, rejected experiments, and superseded
scorecards are not part of the current repository or published crate. A local
copy is retained under `.local-archive/docs-2026-08-15/` in the development
workspace only.