Contributing Documentation

Help improve the AI Templates documentation. Fork the repo, make changes, and submit pull requests.

Contributing to Documentation

Help improve the AI Templates documentation! This guide shows you how to contribute to this site.

Quick Start

1. Fork the repository: AI Templates website on GitHub
2. Make your changes: Edit markdown files in content/
3. Test locally: Run ./serve.sh to preview
4. Submit a pull request: Include description of changes

Documentation Structure

content/
├── templates/          # Template documentation
│   ├── mcp-server/    # MCP Server guides
│   ├── agent/         # Agent guides
│   └── ui/            # UI guides
├── tools/             # Tool setup guides
├── guides/            # Tutorials and workshops
└── reference/         # Stack architecture, config, enterprise features

Writing Guidelines

Style

• Clear and concise: Get to the point quickly
• Code examples: Include working code samples
• Test instructions: Verify all steps work
• No emojis: Keep it professional

Markdown Format

We use Markdown with custom shortcodes:

  

    
  
  

    Info
    Info
  
  

    

      Important information here
    
  








  

    
  
  

    Tip
    Tip
  
  

    

      Helpful tip here
    
  








  

    
  
  

    Warning
    Warning
  
  

    

      Warning message here
    
  

Diagrams

Use Mermaid for diagrams:

graph TD
    A[Start] --> B[End]

Testing Changes

This site does not use pre-commit hooks. Run these before opening a pull request:

# Preview in the browser
./serve.sh

# Production build (required)
hugo --gc --minify

# Super Linter — same as CI (may not run on Apple Silicon; check the PR workflow)
make super-linter

# Optional: broken-link scan (nightly in CI)
make test

On M-series Macs, make super-linter can fail because the container image has no ARM build. Confirm the Super linter check passes on your pull request in GitHub Actions instead.

Also verify formatting in the browser and test at multiple screen sizes.

Submitting Changes

1. Create a branch: git checkout -b fix/improve-docs
2. Make changes: Edit files, test locally
3. Commit: git commit -m "docs: improve MCP server guide"
4. Push: git push origin fix/improve-docs
5. Open PR: Create pull request on GitHub

Need Help?

• Questions: GitHub Discussions
• Issues: File in the website repository

Thank you for contributing! 🙏