Move topic pages to section index routes, standardize card-based content presentation, and simplify metadata typing while improving local search indexing for EnhancedLink entries. Refresh theme styling and replace unstable external links to keep metadata builds reliable.
Landing page improvements:
- Removed Contributing and License sections for cleaner focus
- Updated Quick Start to remove external GitHub links
- Added Popular Tools section with beginner-friendly recommendations
- Organized tools by category (Beginners, API Documentation, QA)
- Added subtle call-to-action footer linking to contributing page
- Improved navigation flow to keep users on the documentation site
Contributing page enhancements:
- Merged license information from landing page
- Added comprehensive Community & Recognition section
- Included contributor acknowledgments and impact explanation
- Added detailed license explanation (CC0 1.0 Universal)
- Clarified contributing agreement and licensing terms
- Enhanced getting help and community sections
Benefits:
- Landing page is now focused on discovering and using tools
- All contributor/legal information consolidated in one place
- Better user flow from discovery to contribution
- Cleaner separation of concerns between user and contributor content
- Maintained important information while improving organization
- Created new 'Contributing' section for developer-focused content
- Moved installation instructions from guide/installation to contributing/
- Updated installation guide to use Taskfile commands instead of raw pnpm
- Added comprehensive contributing guidelines including:
- Development setup using task commands (setup:deps, docs:dev, etc.)
- Project structure and workflow explanations
- Contribution guidelines and review process
- Development tips and testing procedures
- Updated navigation to include Contributing as top-level item
- Reorganized sidebar to remove installation from Getting Started
- Updated main guide to focus on using documentation vs. contributing
- Removed old guide/installation.md and empty guide/ directory
New structure better separates:
- Guide: For documentation users (how to find and use resources)
- Contributing: For project contributors (how to develop and contribute)
Task commands highlighted:
- task setup:deps (install dependencies)
- task docs:dev (development server)
- task docs:build (build site)
- task docs:preview (preview built site)
