Skip to main content

📚 Documentation Navigation - Diataxis Framework

Find exactly what you need based on your current goal.

🏗️ Documentation Architecture​

🎯 What do you want to do right now?​

🎓 I want to LEARN → Tutorials​

"Teach me how to use this step-by-step"

When to use: You're new to MCP or architectural decision records, want to understand concepts through hands-on practice.

🛠️ I want to SOLVE → How-To Guides​

"Help me fix this specific problem"

When to use: You have a specific issue, error, or task you need to accomplish right now.

📖 I want to LOOK UP → Reference​

"What are the exact parameters for this tool?"

When to use: You know what tool you want to use but need exact syntax, parameters, or options.

💡 I want to UNDERSTAND → Explanation​

"Why does this work this way?"

When to use: You want to understand the deeper concepts, design decisions, and architectural principles.

🎓 Tutorials​

Learning-oriented • Step-by-step • Safe to experiment

Start here if you're new to MCP ADR Analysis or want to build your skills systematically.

Getting Started Series​

Specialized Learning Paths​

👨‍🎓 New to architectural decision records? Start with Your First MCP Analysis

🛠️ How-To Guides​

Problem-solving • Goal-oriented • Real scenarios

Use these when you need to solve a specific problem or accomplish a particular task.

Common Problems​

Workflow Solutions​

Specific Tasks​

🚨 Having an issue right now? Check Troubleshooting first.

📖 Reference​

Information-oriented • Systematic • Comprehensive

Complete documentation for when you need exact details about tools, parameters, and APIs.

Complete API Documentation​

  • Complete API Reference 📋
    • All 37 tools with parameters, examples, and usage patterns
    • Quick navigation and search functionality
    • Common usage patterns and workflows

Tool Categories​

Configuration Reference​

Schemas and Formats​

  • ADR Templates

    • Standard formats, MADR templates, Y-statements

  • JSON Schemas

    • Tool parameters, response formats, data structures

🔍 Looking for a specific tool? Use the API Reference search.

💡 Explanation​

Understanding-oriented • Conceptual • Background

Deep-dive into concepts, design decisions, and the "why" behind the architecture.

Core Concepts​

Design Decisions​

Advanced Topics​

🤔 Want to understand the bigger picture? Start with Understanding MCP.

🧭 Quick Navigation​

By Experience Level​

By Use Case​

By Problem Type​

📊 Documentation Quality Metrics​

This documentation follows the Diataxis framework for maximum usability:

  • ✅ Tutorials: Learn by doing with safe, guided practice
  • ✅ How-To Guides: Solve real problems with proven solutions
  • ✅ Reference: Look up exact information quickly and reliably
  • ✅ Explanation: Understand concepts and design decisions deeply

Quick Feedback​

Found what you needed? Missing something important? Improve this documentation

Can't find what you need? Search the complete API reference or file an issue to help us improve the documentation.