7b01c7d6ac
Some checks failed
Docs CI / lint-and-preview (push) Has been cancelled
- 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.
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.
|