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
1.1 KiB
1.1 KiB
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.mdand 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.mdso operators and engineers can discover the process without digging through directories. - Extended Docs CI (
.gitea/workflows/docs.yml) to compile event schemas with Ajv (includingajv-formats) and documented the local loop indocs/events/README.md. - Captured the mirror/offline workflow in
docs/ci/20_CI_RECIPES.mdso runners know how to install the Ajv toolchain and publish previews without internet access. - Validated
scanner.report.ready@1,scheduler.rescan.delta@1, andattestor.logged@1schemas 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.