Skip to content

Conversation

@Data-Wise
Copy link
Owner

Summary

  • Triage orphaned docs — deleted 7 dead files (-3,735 lines), fixed broken link, expanded exclude globs (28 patterns), added feature requests to nav
  • Section landing pages — created index.md with grid card navigation for Getting Started, Workflows & Guides, Reference, and Contributing
  • Tags plugin — configured MkDocs Material tags with 14-tag taxonomy, tagged 39 key pages across 4 tiers, added tags index page

Details

51 files changed | +660 / -3,788 lines | Docs-only, no code changes

Tag Taxonomy (14 tags)

getting-started · adhd · commands · dispatchers · git · teaching · configuration · troubleshooting · reference · tutorial · guide · security · quarto · dopamine

Test plan

  • mkdocs build succeeds without errors
  • mkdocs serve — landing pages render with grid cards
  • /tags/ page lists all 14 tags with linked pages
  • Light + dark mode both render correctly
  • mkdocs gh-deploy --force after merge

🤖 Generated with Claude Code

Test User and others added 4 commits February 2, 2026 12:15
- Bump version references from v6.1.0 to v6.2.0
- Add v6.2.0 release entry (docs overhaul + website reorganization)
- Update current status and recent improvements
- Mark teach-comprehensive feature as completed in .STATUS
- Clean up worktree references

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Delete 7 orphaned docs (superseded plans, session artifacts, duplicates)
- Fix broken link in choose-your-path.md (quick-reference-card → help/QUICK-REFERENCE)
- Add 3 feature request docs to Contributing > Planning nav
- Expand exclude globs to suppress warnings from artifact directories
  (specs, reports, plans, bugs, diagrams, releases, demos, and
  pattern-matched session/brainstorm files)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Create index.md for 4 sections that previously lacked landing pages:
- Getting Started: grid cards for Choose Path, Quick Start, Install, I'm Stuck
- Workflows & Guides: grid cards for Quick Wins, Git, Dotfiles, Tools, Advanced
- Reference: grid cards for API/Architecture, Commands, Refcards, Deep Dives
- Contributing: grid cards for Dev Guide, Branch Workflow, Testing, Docs Style

Each landing page follows a consistent pattern:
- One-line tagline with tldr quick start
- Grid card navigation with emoji icons
- Complete "What's Here" table listing all section pages
- Version footer with home link

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Configure tags plugin with 14-tag taxonomy for topic-based navigation:
  getting-started, adhd, commands, dispatchers, git, teaching,
  configuration, troubleshooting, reference, tutorial, guide,
  security, quarto, dopamine

- Add tags plugin to mkdocs.yml with tags_file pointing to tags.md
- Create docs/tags.md with Material tags marker
- Add Tags Index to Reference section nav
- Tag 39 pages across 4 tiers:
  - Tier 1: 4 landing pages (from previous commit)
  - Tier 2: 15 high-traffic pages (index, quick-start, FAQ, tutorials)
  - Tier 3: 12 dispatcher tutorials and workflow guides
  - Tier 4: 8 teaching/quarto pages

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@Data-Wise Data-Wise merged commit 1784d2b into main Feb 3, 2026
2 checks passed
Data-Wise added a commit that referenced this pull request Feb 3, 2026
Release: v6.2.1 - Docs triage, landing pages, tags
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.

2 participants