Home

Evidentia wiki

The canonical reference for using, extending, and operating Evidentia. Six sections; reading-path optimized for first-time users to walk top-to-bottom.

Sections

1. Getting Started — install + 5-minute quickstart + first collector wire-up.
2. Guides — task-oriented how-tos (gap analysis, OCSF ingest, SARIF emit, POA&M management, CI integration, OSPS self-assessment, etc.).
3. Concepts — explanation + architecture; what's frozen vs evolving; how the catalog/crosswalk/evidence-integrity engines work.
4. Reference — CLI verbs, MCP tools, API symbols (auto-gen via mkdocstrings), configuration, catalog + crosswalk listings.
5. Compliance — the differentiator section: catalog inventory, framework conformance claims, crosswalk index, OSPS Baseline mapping, OCSF mapping, Gemara mapping, financial-sector overlay, contributing a catalog.
6. Project — project meta: roadmap, changelog, API stability, versioning, governance, security, contributing, EOL, verification, FAQ.

How to navigate

• First-time user: start at Getting Started → Quickstart.
• Operator running Evidentia in CI: jump to Guides → CI integration + Guides → Emit SARIF.
• Compliance engineer adding a framework: jump to Compliance → Contributing a catalog + Concepts → Catalog engine.
• Auditor verifying release artifacts: jump to Project → Verification + Project → Security.
• Looking up a CLI flag or MCP tool signature: jump to Reference.

Source + contributions

Wiki source lives in-repo at docs/wiki/. Edits go through normal PR review. The wiki is built with Material for MkDocs from the markdown source; see the canonical mkdocs.yml at repo root for build config.

To contribute: PR to docs/wiki/<section>/<page>.md. New pages must include an entry in their section's index.md.