master
daa6a4ae8c
Some checks failed
Docs CI / lint-and-preview (push) Has been cancelled
Build Test Deploy / build-test (push) Has been cancelled
Build Test Deploy / authority-container (push) Has been cancelled
Build Test Deploy / docs (push) Has been cancelled
Build Test Deploy / deploy (push) Has been cancelled
15 lines
1.1 KiB
Markdown
15 lines
1.1 KiB
Markdown
# Docs Guild Update — 2025-10-18
|
|
|
|
**Subject:** ADR process + events schema validation shipped
|
|
**Audience:** Docs Guild, DevEx, Platform Events
|
|
|
|
- Published the ADR contribution guide at `docs/adr/index.md` and enriched the template to capture authorship, deciders, and alternatives. All new cross-module decisions should follow this workflow.
|
|
- Linked the ADR hub from `docs/README.md` so operators and engineers can discover the process without digging through directories.
|
|
- Extended Docs CI (`.gitea/workflows/docs.yml`) to compile event schemas with Ajv (including `ajv-formats`) and documented the local loop in `docs/events/README.md`.
|
|
- Captured the mirror/offline workflow in `docs/ci/20_CI_RECIPES.md` so runners know how to install the Ajv toolchain and publish previews without internet access.
|
|
- Validated `scanner.report.ready@1`, `scheduler.rescan.delta@1`, and `attestor.logged@1` schemas locally to unblock Platform Events acknowledgements.
|
|
|
|
Next steps:
|
|
- Platform Events to confirm Notify/Scheduler consumers have visibility into the schema docs.
|
|
- DevEx to add ADR announcement blurb to the next sprint recap if broader broadcast is needed.
|