Files
claude-howto/07-plugins/documentation
Luong NGUYEN 5caeff2f1c refactor: Reorganize repository structure for optimal learning path
Reorder folders based on learning dependencies, complexity, and frequency of use:
- 01-slash-commands (unchanged) - Quick wins for beginners
- 02-memory (was 03) - Essential foundation
- 03-skills (was 05) - Auto-invoked capabilities
- 04-subagents (was 02) - Task delegation
- 05-mcp (was 04) - External integration
- 06-hooks (was 07) - Event automation
- 07-plugins (was 06) - Bundled solutions
- 08-checkpoints (unchanged) - Safe experimentation
- 09-advanced-features (unchanged) - Power user tools

Documentation improvements:
- Add LEARNING-ROADMAP.md with detailed milestones and exercises
- Simplify README.md for better scannability
- Consolidate Quick Start and Getting Started sections
- Combine Feature Comparison and Use Case Matrix tables
- Reorder README sections: Learning Path → Quick Reference → Getting Started
- Update all cross-references across module READMEs

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-09 17:54:58 +01:00
..

Claude How To

Documentation Plugin

Comprehensive documentation generation and maintenance for your project.

Features

API documentation generation README creation and updates Documentation synchronization Code comment improvements Example generation

Installation

/plugin install documentation

What's Included

Slash Commands

  • /generate-api-docs - Generate API documentation
  • /generate-readme - Create or update README
  • /sync-docs - Sync docs with code changes
  • /validate-docs - Validate documentation

Subagents

  • api-documenter - API documentation specialist
  • code-commentator - Code comment improvements
  • example-generator - Code example creation

Templates

  • api-endpoint.md - API endpoint documentation template
  • function-docs.md - Function documentation template
  • adr-template.md - Architecture Decision Record template

MCP Servers

  • GitHub integration for documentation syncing

Usage

Generate API Documentation

/generate-api-docs

Create README

/generate-readme

Sync Documentation

/sync-docs

Validate Documentation

/validate-docs

Requirements

  • Claude Code 1.0+
  • GitHub access (optional)

Example Workflow

User: /generate-api-docs

Claude:
1. Scans all API endpoints in /src/api/
2. Delegates to api-documenter subagent
3. Extracts function signatures and JSDoc
4. Organizes by module/endpoint
5. Uses api-endpoint.md template
6. Generates comprehensive markdown docs
7. Includes curl, JavaScript, and Python examples

Result:
✅ API documentation generated
📄 Files created:
   - docs/api/users.md
   - docs/api/auth.md
   - docs/api/products.md
📊 Coverage: 23/23 endpoints documented

Templates Usage

API Endpoint Template

Use for documenting REST API endpoints with full examples.

Function Documentation Template

Use for documenting individual functions/methods.

ADR Template

Use for documenting architectural decisions.

Configuration

Set up GitHub token for documentation syncing:

export GITHUB_TOKEN="your_github_token"

Best Practices

  • Keep documentation close to code
  • Update docs with code changes
  • Include practical examples
  • Validate regularly
  • Use templates for consistency