Files
git.stella-ops.org/docs/implplan/archived/updates/2025-10-18-docs-guild.md
master 7b01c7d6ac
Some checks failed
Docs CI / lint-and-preview (push) Has been cancelled
feat: Add comprehensive product advisories for improved scanner functionality
- Introduced a blueprint for explainable quiet alerts, detailing phases for SBOM, VEX readiness, and attestations.
- Developed a roadmap for deterministic diff-aware rescans, enhancing scanner speed and efficiency.
- Implemented a hash-based SBOM layer cache to optimize container scans by reusing previous results.
- Created a multi-runtime reachability corpus to validate function-level reachability across various programming languages.
- Proposed a stable SBOM model using SPDX 3.0.1 for persistence and CycloneDX 1.6 for interchange.
- Established a validation plan for quiet scans, focusing on provenance and CI integration.
- Documented guidelines for the Findings Ledger module, outlining roles, execution rules, and testing protocols.
2025-11-17 00:09:26 +02:00

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.