Skip to content

Sync: docs update — teaching refresh, consolidation, lint#429

Merged
Data-Wise merged 5 commits intomainfrom
dev
Feb 27, 2026
Merged

Sync: docs update — teaching refresh, consolidation, lint#429
Data-Wise merged 5 commits intomainfrom
dev

Conversation

@Data-Wise
Copy link
Owner

Summary

  • Teaching docs refresh — Update 30 files: version refs (v5.x/v6.x → v7.6.0), dates, content gaps (missing teach subcommands in commands table and hub index), fix tutorial 14 branch naming
  • CHANGELOG sync — Root v7.6.0 entry synced with docs/ version (adds Scholar Config Sync, fixes, correct 53/53 test count)
  • Doc consolidation — Merge duplicate TEACHING-SYSTEM-ARCHITECTURE, archive 11 orphaned files to docs/.archive/, simplify mkdocs exclude list
  • Lint fixes — MD031, MD029, MD040 across 7 teaching doc files
  • Post-release — Move brainstorm files to docs/specs/, fix broken relative links

Test plan

  • mkdocs build --strict passes (0 warnings, 0 errors)
  • All changes are docs-only (no code changes)
  • Pre-commit Prettier hook passed on all commits

🤖 Generated with Claude Code

Test User and others added 5 commits February 27, 2026 14:44
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Update 30 teaching doc files to v7.6.0:
- Bump version headers/footers from v5.x/v6.x to v7.6.0 across tutorials,
  guides, refcards, architecture docs, and teaching hub index
- Add missing teach subcommands to commands table and reference (solution,
  sync, validate-r, style, config check/diff/show/scaffold)
- Expand teaching hub features table with 5 new entries
- Fix tutorial 14 branch naming: "production" → "main" (matches dispatcher default)
- Remove stale inline version annotations from section headers

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Sync root CHANGELOG.md v7.6.0 entry with docs/ version (adds Scholar
  Config Sync, fix details, correct test count 53/53)
- Move 2 BRAINSTORM-*.md files from repo root to docs/specs/
- Fix MD031 (blanks around fences) in tutorials 26, 45
- Fix MD029 (ordered list prefix) in BACKUP-SYSTEM-GUIDE, TEACH-DEPLOY-GUIDE
- Fix MD040 (missing code fence language) in SCHOLAR-INTEGRATION-GUIDE,
  REFCARD-SCHOLAR-WRAPPERS, REFCARD-MACROS

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Merge TEACHING-SYSTEM-ARCHITECTURE.md duplicate: replace guides/ copy
  with root copy (more current, shows Scholar v2.0.1 COMPLETE status),
  delete root orphan
- Archive 11 orphaned docs to docs/.archive/ (4,407 lines of reports,
  summaries, and plans with no nav entries):
  DOCS-HEALTH-CHECK-REPORT, DOCS-VALIDATION-REPORT, DOT-DISPATCHER-SUMMARY,
  HOOK-SYSTEM-IMPLEMENTATION, LINT-FEATURE-SUMMARY, PHASE3/4-SUMMARY,
  REFERENCE-CONSOLIDATION-PLAN, TEST-COVERAGE-ANALYSIS/COMPLETE,
  TUTORIAL-WORKFLOW-INTEGRATION-OPTIONS
- Simplify mkdocs exclude list: replace 8 individual globs with
  single .archive/** pattern
- Remove stale TEACHING-SYSTEM-ARCHITECTURE.md from exclude list

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
After moving from docs/ root to docs/guides/, internal links using
guides/ prefix resolved to guides/guides/. Fix 3 links to use
relative paths within the same directory.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@Data-Wise Data-Wise merged commit c7599f8 into main Feb 27, 2026
2 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