Documentation Generation Specialist

Quick Reference (30 seconds)

Automated Documentation Generation - Comprehensive documentation automation covering technical specs, API documentation, user guides, and knowledge base creation with multi-format output capabilities.

Core Capabilities:

• •Technical Documentation: API docs, architecture specs, code documentation
• •User Guides: Tutorials, getting started guides, best practices
• •API Documentation: OpenAPI/Swagger generation, endpoint documentation
• •Multi-Format Output: Markdown, HTML, PDF, static sites
• •AI-Powered Generation: Context-aware content creation and enhancement
• •Continuous Updates: Auto-sync documentation with code changes

When to Use:

• •Generating API documentation from code
• •Creating technical specifications and architecture docs
• •Building user guides and tutorials
• •Automating knowledge base creation
• •Maintaining up-to-date project documentation

Implementation Guide (5 minutes)

Quick Start Workflow

Basic Documentation Generation:

from moai_docs_generation import DocumentationGenerator

# Initialize generator
doc_gen = DocumentationGenerator()

# Generate API documentation
api_docs = doc_gen.generate_api_docs("path/to/your/app.py")

# Create user guide
user_guide = doc_gen.generate_user_guide(project_info)

# Export to multiple formats
doc_gen.export_to_formats(api_docs, formats=["html", "pdf", "markdown"])

Single Command Documentation:

# Generate complete documentation
moai generate-docs --source ./src --output ./docs --formats html,pdf

# Update API docs from code
moai update-api-docs --app-file app.py --format openapi

# Create tutorial from feature
moai create-tutorial --feature authentication --output docs/tutorials/

Core Components

1. •API Documentation (modules/api-documentation.md)

• •OpenAPI/Swagger specification generation
• •Interactive HTML documentation
• •Code example generation
• •Request/response documentation

1. •Code Documentation (modules/code-documentation.md)

• •AST-based code analysis
• •AI-powered docstring enhancement
• •Automatic documentation structure extraction
• •Multi-format documentation generation

1. •User Guides (modules/user-guides.md)

• •Getting started guides
• •Feature tutorials
• •Cookbook generation
• •Step-by-step instructions

1. •Multi-Format Output (modules/multi-format-output.md)

• •HTML site generation
• •PDF documentation
• •Static site export
• •Responsive design templates

Advanced Patterns (10+ minutes)

Continuous Documentation Integration

Git Hooks for Auto-Documentation:

# .git/hooks/pre-commit
#!/bin/bash
# Auto-update documentation before commits

python -c "
from moai_docs_generation import DocumentationGenerator
doc_gen = DocumentationGenerator()
doc_gen.update_documentation_for_changed_files()
"

CI/CD Pipeline Integration:

# .github/workflows/docs.yml
name: Generate Documentation
on:
 push:
 branches: [main]

jobs:
 docs:
 runs-on: ubuntu-latest
 steps:
 - uses: actions/checkout@v2
 - name: Generate Documentation
 run: |
 moai generate-docs --source ./src --output ./docs
 moai deploy-docs --platform github-pages

AI-Enhanced Documentation

Smart Content Generation:

# AI-powered example generation
ai_enhanced_docs = doc_gen.generate_with_ai(
 source_code="path/to/code",
 enhancement_level="comprehensive",
 include_examples=True,
 include_troubleshooting=True
)

Documentation Quality Automation

Automated Quality Checks:

# Validate documentation quality
quality_report = doc_gen.validate_documentation(
 completeness_threshold=0.9,
 include_example_validation=True,
 check_link_integrity=True
)

Works Well With

Complementary Skills:

• •moai-foundation-core - SPEC-first documentation approach
• •moai-workflow-project - Project documentation integration
• •moai-lang-unified - Multi-language code documentation
• •moai-integration-mcp - External documentation platform integration

Technology Integration:

• •FastAPI/Flask applications
• •Sphinx/MkDocs documentation
• •GitHub/GitLab wikis
• •Confluence knowledge bases
• •Static site generators (Hugo, Jekyll)

Usage Examples

Command Line Interface

# Complete documentation suite
moai docs:generate --project ./my-project --output ./docs

# API documentation only
moai docs:api --source ./app.py --format openapi,html

# User guide creation
moai docs:guide --features auth,user-management --template getting-started

# Documentation updates
moai docs:update --sync-with-code --validate-links

Python API

from moai_docs_generation import DocumentationGenerator

# Complete workflow
generator = DocumentationGenerator()
docs = generator.generate_comprehensive_docs(
 source_directory="./src",
 include_api_docs=True,
 include_user_guides=True,
 output_formats=["html", "pdf", "markdown"]
)

# Individual components
api_gen = API Documentation Generation()
api_spec = api_gen.generate_openapi_spec(fastapi_app)

code_gen = Code Documentation Enhancement()
enhanced_docs = code_gen.analyze_and_enhance("./src/")

Technology Stack

Core Technologies:

• •Python 3.8+ (main implementation)
• •FastAPI/Flask (API documentation)
• •Jinja2 (HTML templating)
• •Markdown (content formatting)
• •WeasyPrint (PDF generation)

Optional Integrations:

• •AI services (content enhancement)
• •Git hooks (auto-updates)
• •CI/CD platforms (continuous deployment)
• •Static site generators (hosting)
• •Documentation platforms (confluence)

Output Formats:

• •HTML (responsive sites)
• •PDF (print-ready documents)
• •Markdown (version control friendly)
• •OpenAPI/Swagger (API specifications)
• •Static sites (hosting platforms)

For detailed implementation patterns and advanced configurations, see the modules/ directory.