Skip to content

docs: doc-claim drift detected on 2026-06-22#15

Open
NickCrew wants to merge 1 commit into
mainfrom
docs/drift-2026-06-22
Open

docs: doc-claim drift detected on 2026-06-22#15
NickCrew wants to merge 1 commit into
mainfrom
docs/drift-2026-06-22

Conversation

@NickCrew

Copy link
Copy Markdown
Collaborator

Automated doc-drift scan across 12 doc files found 37 findings in 10 files (2 clean).

Severity summary

Severity Count Meaning
P0 11 User-facing factual errors (wrong defaults, broken commands, nonexistent routes)
P1 24 Dev-doc errors (wrong paths, missing files, stale APIs)
P2 2 Minor staleness

P0 highlights (breaking / user-visible)

  • DEMO_MODE default documented as strict or true in 4 files — actual default is full (app/config.py:31)
  • make -C apps/vuln-api test-* in README and developer-guide — no Makefile exists, only justfile
  • Docker port mapping -p 8880:8880 in dockerhub-overview — container listens on 80, so mapping must be -p 8880:80
  • GET /api/v1/accounts/balance, POST /api/v1/transfers/wire in api-reference — neither route exists
  • ENABLE_VULNERABILITIES=true in API-DOCUMENTATION — env var doesn't exist in app/config.py
  • Broken link docs/API-DOCUMENTATION.md in apps/vuln-api/README.md — file is at repo root, not in docs/

Backlog task

All 37 findings with per-finding fix proposals and acceptance criteria are in:
backlog/tasks/task-17 - Doc-drift-detected-2026-06-22.md

This PR adds only the backlog task file. It does not modify any of the 12 audited doc files — fixes belong in a follow-up task.


Generated by Claude Code

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