Skip to content

v1.15.0 - ADHD-Friendly Website Enhancements

Choose a tag to compare

View all tags
@Data-Wise Data-Wise released this 01 Jan 00:29
· 126 commits to main since this release
v1.15.0
454dfdd

🎯 ADHD-Friendly Website Enhancements

Major release focused on making documentation sites more accessible and readable for ADHD developers through comprehensive rendering fixes and enhanced command templates.

✨ New Features

/craft:docs:website Command

Complete ADHD-friendly website enhancement workflow with 3-phase optimization:

  • Phase 1: Quick wins (TL;DR boxes, mermaid fixes, time estimates)
  • Phase 2: Structure improvements (visual workflows, navigation)
  • Phase 3: Polish & mobile responsive design

Includes ADHD scoring algorithm (0-100) across 5 categories:

  • Visual Hierarchy (25%)
  • Time Estimates (20%)
  • Workflow Diagrams (20%)
  • Mobile Responsive (15%)
  • Content Density (20%)

🐛 Fixes

Emoji Icon Rendering

  • Added pymdownx.emoji extension to all documentation
  • Emoji shortcodes (:rocket:, :brain:, etc.) now render as actual icons
  • Updated /craft:site:create to include emoji support by default

Mermaid Diagram Layouts

  • Fixed Site Creation Workflow: horizontal → vertical layout
  • Fixed Git Worktree Workflow: added subgraph for parallel processes
  • Updated mermaid-linter skill with layout best practices
  • All diagrams now mobile-friendly with proper spacing

Markdown Rendering

  • Fixed list formatting (added empty lines before lists)
  • Fixed TL;DR box spacing throughout documentation
  • Improved visual hierarchy and scannability

📦 Command Updates

/craft:site:create

Enhanced mkdocs.yml template now includes:

  • pymdownx.emoji for emoji icon rendering
  • pymdownx.superfences with mermaid custom_fences
  • attr_list and md_in_html for enhanced markdown

Mermaid Linter Skill

Added "Layout Direction Best Practices" section:

  • Prefer flowchart TD (vertical) over flowchart LR (horizontal)
  • Guidance on when to use subgraphs
  • Examples of good vs bad layouts
  • Mobile and ADHD-friendly considerations

📊 Impact

ADHD Score Improvement:

  • Before: 74/100
  • After: 79/100 (+5 points)

Documentation Site:

📝 Files Changed

  • Configuration: mkdocs.yml
  • Documentation: WORKFLOWS.md, index.md, ADHD-QUICK-START.md
  • Commands: site/create.md, docs/website.md (new)
  • Skills: mermaid-linter/skill.md
  • Project: README.md, ROADMAP.md, plugin.json

🚀 Upgrade Notes

For Existing Sites:
Run /craft:docs:website --analyze to check your ADHD score and get enhancement recommendations.

For New Sites:
All sites created with /craft:site:create now automatically include:

  • Emoji icon support
  • Mermaid diagram rendering
  • ADHD-friendly best practices

Full Changelog: v1.14.0...v1.15.0

🤖 Generated with Claude Code

Assets 2
Loading