Skip to content

Conversation

ryanrozich
Copy link
Owner

Summary

Comprehensive documentation audit and reorganization as requested in issue #84.

Changes

New Documentation Structure

  • Created organized structure in docs/ directory:
    • components/ - Component-specific documentation
    • development/ - Developer guides (setup, workflow, testing, contributing, architecture)
    • deployment/ - Deployment documentation
    • api/ - API reference
    • examples/ - Code examples and patterns

Files Archived

  • Moved internal/process documentation to docs-archive/ (gitignored)
  • Archived outdated content while preserving git history
  • Removed temporary/internal files from version control

Files Preserved

  • Kept CLAUDE.md in root as it contains AI agent instructions
  • Maintained all user-facing documentation

Documentation Created

  • docs/README.md - Navigation index for all documentation
  • docs/development/setup.md - Getting started guide
  • docs/development/testing.md - Testing guide
  • docs/development/contributing.md - Contribution guidelines
  • docs/development/architecture.md - Architecture overview
  • docs/api/README.md - API reference index
  • docs/examples/README.md - Code examples
  • docs/components/filter-presets.md - Filter presets overview
  • docs/components/category-selector.md - Placeholder for upcoming feature (Feature: Add category management and export functionality to filter presets #77)

Updates

  • Updated main README.md with links to new documentation structure
  • Updated .gitignore to exclude archived documentation
  • Reorganized component API docs into docs/components/

Notes

  • PR docs: reorganize documentation structure #21 was reviewed but had conflicts; incorporated the good ideas
  • All internal documentation moved to gitignored archive
  • Documentation now reflects current codebase state
  • Clear navigation structure implemented

Fixes #84

Test Plan

  • All documentation links tested and working
  • Git history preserved for moved files
  • Archive directory properly gitignored
  • Main README updated with new links

- Create new documentation structure with clear organization
- Move internal/process docs to docs-archive/ (gitignored)
- Reorganize component docs into docs/components/
- Add comprehensive development guides in docs/development/
- Create API reference structure in docs/api/
- Add examples documentation in docs/examples/
- Update .gitignore to exclude archived documentation
- Update main README with links to new documentation structure
- Create navigation README in docs/ directory
- Preserve CLAUDE.md as it contains AI agent instructions
@github-actions github-actions bot added status: in-code-review PR ready, awaiting code review documentation Improvements or additions to documentation area: docs Documentation (README, API docs, guides) priority: high Important, should be fixed soon and removed status: in-code-review PR ready, awaiting code review labels Jul 10, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area: docs Documentation (README, API docs, guides) documentation Improvements or additions to documentation priority: high Important, should be fixed soon
Projects
Status: No status
Development

Successfully merging this pull request may close these issues.

1 participant