docs: deep-review accuracy fixes (counts, anchors, roadmap, version policy)#26
Merged
Conversation
…olicy) RedTeam + IterativeDepth multi-lens review of docs/ surfaced verified defects: - core/how-to-use.md: drop hardcoded '14 infrastructure modules' (was stale; canonical is 20) — link to canonical_facts instead of a competing literal. - development/roadmap.md: promote v3.2.0 from Planned to Completed Releases (shipped 2026-06-04); refresh 'Last verified' to 2026-06-05; reframe the open-backlog block to current TO-DO IDs. - development/security.md: supported-versions table 3.1.x -> 3.2.x (v3.2.0 is the current release). - _generated/canonical_facts.md: template_active_inference test count 269 -> 343 (re-derived after the v3.2.0 validation-spine additions). - documentation-index.md: add missing entries — ADR-005, rules/memory_and_decision_records.md, and 6 prompt SKILLs (academic-paper, academic-paper-reviewer, academic-pipeline, agentic-use, deep-research, methods-orchestration). - documentation-index.md + reference/quick-start-cheatsheet.md: point the Pitfall-6 links at the stable explicit anchor #pitfall-6-root-venv (heading-text-independent). - best-practices/migration-guide.md: fix README link path ../README.md -> ../../README.md (the migration-from-quadmath anchor lives in the repo-root README). - README.md: Python version — state 3.10+ (requires-python; CI tests 3.10-3.12) instead of implying 3.12 is required. Verifier-first: every claim checked against the repo. Rejected one false finding (the '#learnings--known-issues' double-hyphen anchor is the CORRECT GitHub slug for 'Learnings & Known Issues' — changing it would break a working link).
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
A deep multi-lens RedTeam + IterativeDepth review of
docs/(366 files, 6 parallel verifier lenses, verify-don't-trust against the actual repo). Every fix below was confirmed against the tree.Fixes
canonical_facts.mdinstead of a competing literal.template_active_inferencetest count 269 → 343 (re-derived after the v3.2.0 spine additions; the only count I could verify reliably in its own venv).#pitfall-6-root-venv(heading-text-independent; both pointed at the long auto-slug before).../README.md→../../README.md(themigration-from-quadmathanchor lives in the repo-root README, not docs/README.md).requires-python; CI tests 3.10–3.12) instead of implying 3.12 is required.RedTeam note (verifier caught a false finding)
A lens flagged
#learnings--known-issues(double hyphen) as broken. Rejected — that is the correct GitHub slug for the heading "Learnings & Known Issues" (&strips, leaving two spaces →--). Changing it would have broken a working link. Left as-is.Verification
lint_docslinks / consistency / doc-pairs — all exit 0 (run against this branch).🤖 Generated with Claude Code