Skip to content

docs(readme): refresh for current deliverables and visual appeal - #71

Merged
emmanuelgjr merged 1 commit into
mainfrom
docs/readme-refresh
Sep 15, 2026
Merged

emmanuelgjr merged 1 commit into
mainfrom
docs/readme-refresh

Conversation

@emmanuelgjr

Copy link
Copy Markdown
Contributor

The README predated most of what this repo now ships — the crosswalk section said 21 frameworks (it's 26, with 3,803 mappings across 51 entries), the DSGAI Scanner wasn't mentioned at all, and datasets that hold data were still listed as "proposed".

What changed

  • Header: centered title + tagline, badge row (OWASP · live webapp · DSGAI 21 risks · frameworks 26 · scanner v0.3.0 · CC BY-SA 4.0 · PRs welcome), quick-nav with explicit <a id> anchors (emoji headings make GitHub's auto-slugs unreliable).
  • Crosswalk: prominent CTA to the live webapp plus a feature table deep-linking Score Your Coverage, Explorer, the 51×26 Coverage Matrix, Incidents, and Submit-a-Standard. Stats corrected to 51 entries / 4 source lists / 26 frameworks / 3,800+ mappings / 131 incidents. The framework list now names the 26 actually mapped (verified against data/frameworks/ in the crosswalk repo); the old list named frameworks the crosswalk doesn't carry (COBIT, BSIMM, FAIR, OPENCRE…).
  • New scanner section: v0.3.0, deterministic 107-rule engine, language coverage, SARIF/Semgrep/gitleaks integrations, quick-start snippet, sample report in a details block.
  • Datasets: table with real counts (exploit 59 · vulnerability 47 · risk-assessment 23 · prompt-injection 300+ · RAG growing · incidents and agent-traces seeking contributors · cross-framework mapping → crosswalk repo).
  • Added: at-a-glance deliverables table, repository map, condensed workstream table.
  • Kept everything else: both white papers, the DSGAI01–21 table, risk-database collaboration, contribute section, OWASP initiatives table, acknowledgments, license.

Verification

  • Every relative path checked against the tree — all exist.
  • Every external URL curl-checked with a browser UA — all 2xx/3xx except owasp.slack.com (403 to bots) and LinkedIn (405 to HEAD), both unchanged from the previous README.
  • All numbers verified against the crosswalk repo's data/stats.json (v4.0.0) and this repo's dataset folders today.

Repo topics were also updated for discoverability (owasp, ai-security, llm-security, data-security, dsgai, risk-taxonomy, prompt-injection, agentic-ai, mitre-atlas, security-datasets, security-scanner).

🤖 Generated with Claude Code

https://claude.ai/code/session_01KJVKF6raJCNKBWjTkDSqR4

The README predated most of what the repo now ships. Rewrite it:

- Centered header with tagline, badge row (OWASP, live-webapp,
  DSGAI-21, frameworks-26, scanner v0.3.0, license, PRs-welcome) and a
  quick-nav line with explicit anchors.
- Prominent call-to-action to the Crosswalk webapp, and a feature table
  with deep links (Score Your Coverage, Explorer, Coverage Matrix,
  Incidents, Submit a Standard).
- Crosswalk stats corrected: 51 entries across 4 source lists x 26
  frameworks, 3,800+ mappings, 131 incidents; framework list replaced
  with the 26 actually mapped (was a stale 21-framework list naming
  frameworks the crosswalk does not carry).
- New DSGAI Scanner section (previously absent): v0.3.0, 107 rules,
  languages, SARIF/Semgrep/gitleaks, quick start, sample report.
- Datasets table with real per-dataset entry counts; datasets that
  exist are no longer listed as 'proposed'.
- At-a-glance deliverables table, repository map, condensed
  workstreams; every prior section kept (white papers, DSGAI table,
  collaboration, contribute, initiatives table, acknowledgments,
  license).

All relative paths verified against the tree; all external URLs return
2xx/3xx with a browser UA except the two known bot-blocks (Slack,
LinkedIn), unchanged from before.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KJVKF6raJCNKBWjTkDSqR4
@emmanuelgjr
emmanuelgjr merged commit 592b618 into main Sep 15, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant