Skip to content

docs: reorganize documentation structure #17

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

zenkodr
Copy link

@zenkodr zenkodr commented Apr 25, 2025

Documentation Restructuring

This PR creates and organizes the documentation to improve navigation, searchability, and maintainability.

Directory Structure

Created a hierarchical documentation structure:

  • 📚 docs/
    • 📖 api/ - API reference and types
    • 📗 guides/ - Core concepts and best practices
    • 📘 features/ - Feature-specific documentation
    • 📙 tutorials/ - Getting started guides

Major Changes

  • Improved Navigation

    • Added clear table of contents
    • Created consistent section anchors
    • Improved cross-references between docs
    • Added search-friendly headers
  • Enhanced Content Structure

    • Separated API reference into dedicated section
    • Organized features documentation by topic
    • Added comprehensive guides section
    • Created step-by-step tutorials
  • Documentation Features

    • Added mermaid diagrams for visual explanations
    • Improved code examples with comments
    • Added type information for TypeScript users
    • Included troubleshooting sections

Updated Sections

  1. API Reference

    • Comprehensive function documentation
    • Type definitions
    • Error handling
    • Configuration options
  2. Guides

    • Core concepts
    • Best practices
    • Performance optimization
    • Troubleshooting
  3. Features

    • Creating functions
    • Using functions
    • Error handling
    • Generator composition
    • Context management
    • Build-time macro
  4. Tutorials

    • Getting started guide
    • Basic examples
    • Step-by-step instructions

Testing Checklist

  • All documentation links verified
  • Code examples tested
  • Navigation structure reviewed
  • Search-friendly headers added
  • Cross-references checked

Impact

This reorganization makes the documentation:

  • More intuitive to navigate
  • Easier to maintain
  • Better for search
  • More comprehensive for users

- Create hierarchical documentation structure
- Add detailed API reference
- Improve navigation and cross-referencing
- Add search-friendly headers
- Update main README.md with new structure
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