Files
git.stella-ops.org/docs/updates/2025-10-18-docs-guild.md

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.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.