# Documentation improvement records

Point-in-time audits and follow-up work for links, terminology, readability, and factual alignment with code.

| Report | Date | Scope |
| --- | --- | --- |
| [2026-07-10 audit](2026-07-10-audit.md) | 2026-07-10 | Full `docs/` + README pass; glossary T0–T4; live demo links |

## Collaboration style

Issues, PRs, and reviews default to **caveman-full** ([`CONTRIBUTING.md`](../../CONTRIBUTING.md#caveman-style-default),
[`AGENTS.md`](../../AGENTS.md#caveman-style-default-for-collaboration)). Gitea templates live under
[`.github/ISSUE_TEMPLATE/`](../../.github/ISSUE_TEMPLATE/) and
[`.github/pull_request_template.md`](../../.github/pull_request_template.md).

## CI automation

Enforced in Gitea Actions (`docs-verify` job). Rules live in [`bin/docs_rules.json`](../../bin/docs_rules.json); see [ci-rules.md](ci-rules.md).

Originally tracked in [issue #1](https://git.produktor.io/eSlider/swarm-house/issues/1).

## How to add a new report

1. Copy the structure from the latest audit file.
2. Name it `YYYY-MM-DD-short-topic.md`.
3. Add a row to the table above.
4. Cross-link from [09 — Open questions](../09-open-questions.md) if new ambiguities appear.