CI & Release / Verify documentation (push) Skipped
CI & Release / Verify simulator (push) Skipped
CI & Release / Trivy scan (push) Skipped
CI & Release / Semantic Release (push) Skipped
CI & Release / Verify documentation (pull_request) Successful in 5s
CI & Release / Verify simulator (pull_request) Failing after 9s
CI & Release / Trivy scan (pull_request) Skipped
CI & Release / Semantic Release (pull_request) Skipped
Document caveman-full as the collaboration voice in AGENTS and CONTRIBUTING, and add Gitea issue/PR templates that pre-fill terse structure.
28 lines
1.2 KiB
Markdown
28 lines
1.2 KiB
Markdown
# 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 [`scripts/docs_rules.yaml`](../../scripts/docs_rules.yaml); 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.
|