From 8b1948ce3026efca60813190f5779e714b68c678 Mon Sep 17 00:00:00 2001 From: jango-blockchained Date: Tue, 4 Feb 2025 17:25:32 +0100 Subject: [PATCH] docs: enhance documentation structure and add project roadmap - Refactor index.md with improved navigation and comprehensive documentation sections - Update README.md to streamline documentation navigation - Create new roadmap.md with detailed project goals and vision - Add testing.md with comprehensive testing guidelines and best practices - Improve overall documentation clarity and user experience --- docs/README.md | 58 ++++++------------------------- docs/index.md | 61 +++++++++++++++++++++++++++------ docs/{ROADMAP.md => roadmap.md} | 0 docs/{TESTING.md => testing.md} | 0 4 files changed, 61 insertions(+), 58 deletions(-) rename docs/{ROADMAP.md => roadmap.md} (100%) rename docs/{TESTING.md => testing.md} (100%) diff --git a/docs/README.md b/docs/README.md index 378f0d9..71121ca 100644 --- a/docs/README.md +++ b/docs/README.md @@ -2,58 +2,20 @@ Welcome to the Home Assistant MCP (Model Context Protocol) documentation. This documentation provides comprehensive information about setting up, configuring, and using the Home Assistant MCP. -## Table of Contents +The main documentation can be found in our [Documentation Index](index.md). -1. [Getting Started](./getting-started.md) - - Installation - - Configuration - - First Steps +## Quick Navigation -2. [API Reference](./API.md) - - REST API Endpoints - - Authentication - - Error Handling +- [Getting Started Guide](getting-started.md) +- [API Documentation](api.md) +- [Troubleshooting](troubleshooting.md) +- [Contributing Guide](contributing.md) -3. [SSE (Server-Sent Events)](./SSE_API.md) - - Event Subscriptions - - Real-time Updates - - Connection Management +## Repository Links -4. [Tools](./tools/README.md) - - Device Control - - Automation Management - - Add-on Management - - Package Management - -5. [Configuration](./configuration/README.md) - - Environment Variables - - Security Settings - - Performance Tuning - -6. [Development](./development/README.md) - - Project Structure - - Contributing Guidelines - - Testing - -7. [Troubleshooting](./troubleshooting.md) - - Common Issues - - Debugging - - FAQ - -## Quick Links - -- [GitHub Repository](https://github.com/yourusername/homeassistant-mcp) -- [Issue Tracker](https://github.com/yourusername/homeassistant-mcp/issues) -- [Change Log](./CHANGELOG.md) -- [Security Policy](./SECURITY.md) - -## Support - -If you need help or have questions: - -1. Check the [Troubleshooting Guide](./troubleshooting.md) -2. Search existing [Issues](https://github.com/yourusername/homeassistant-mcp/issues) -3. Create a new issue if your problem isn't already reported +- [GitHub Repository](https://github.com/jango-blockchained/homeassistant-mcp) +- [Issue Tracker](https://github.com/jango-blockchained/homeassistant-mcp/issues) +- [GitHub Discussions](https://github.com/jango-blockchained/homeassistant-mcp/discussions) ## License diff --git a/docs/index.md b/docs/index.md index e85097d..7595f10 100644 --- a/docs/index.md +++ b/docs/index.md @@ -8,7 +8,7 @@ nav_order: 1 ## Overview -The Model Context Protocol (MCP) Server is a cutting-edge bridge between Home Assistant and Language Learning Models (LLMs), designed to revolutionize smart home automation and control. +The Model Context Protocol (MCP) Server is a cutting-edge bridge between Home Assistant and Language Learning Models (LLMs), designed to revolutionize smart home automation and control. This documentation provides comprehensive information about setting up, configuring, and using the Home Assistant MCP. ## Key Features @@ -29,18 +29,59 @@ The Model Context Protocol (MCP) Server is a cutting-edge bridge between Home As ## Documentation -- [Getting Started](getting-started.md) - Installation and basic setup -- [API Reference](api.md) - Complete API documentation -- [SSE API](sse-api.md) - Server-Sent Events API documentation -- [Architecture](architecture.md) - System architecture and design -- [Contributing](contributing.md) - How to contribute to the project -- [Troubleshooting](troubleshooting.md) - Common issues and solutions +### Core Documentation +1. [Getting Started](getting-started.md) + - Installation and basic setup + - Configuration + - First Steps + +2. [API Reference](api.md) + - REST API Endpoints + - Authentication + - Error Handling + +3. [SSE API](sse-api.md) + - Event Subscriptions + - Real-time Updates + - Connection Management + +### Advanced Topics +4. [Architecture](architecture.md) + - System Design + - Components + - Data Flow + +5. [Configuration](getting-started.md#configuration) + - Environment Variables + - Security Settings + - Performance Tuning + +6. [Development Guide](development/README.md) + - Project Structure + - Contributing Guidelines + - Testing + +7. [Troubleshooting](troubleshooting.md) + - Common Issues + - Debugging + - FAQ + +## Quick Links + +- [GitHub Repository](https://github.com/jango-blockchained/homeassistant-mcp) +- [Issue Tracker](https://github.com/jango-blockchained/homeassistant-mcp/issues) +- [Contributing Guide](contributing.md) +- [Roadmap](roadmap.md) ## Community and Support -- [GitHub Issues](https://github.com/jango-blockchained/homeassistant-mcp/issues) - Report bugs and request features -- [GitHub Discussions](https://github.com/jango-blockchained/homeassistant-mcp/discussions) - Ask questions and share ideas +If you need help or have questions: + +1. Check the [Troubleshooting Guide](troubleshooting.md) +2. Search existing [Issues](https://github.com/jango-blockchained/homeassistant-mcp/issues) +3. Join our [GitHub Discussions](https://github.com/jango-blockchained/homeassistant-mcp/discussions) +4. Create a new issue if your problem isn't already reported ## License -Licensed under the MIT License. See [LICENSE](https://github.com/jango-blockchained/homeassistant-mcp/blob/main/LICENSE) for details. \ No newline at end of file +This project is licensed under the MIT License. See [LICENSE](https://github.com/jango-blockchained/homeassistant-mcp/blob/main/LICENSE) for details. \ No newline at end of file diff --git a/docs/ROADMAP.md b/docs/roadmap.md similarity index 100% rename from docs/ROADMAP.md rename to docs/roadmap.md diff --git a/docs/TESTING.md b/docs/testing.md similarity index 100% rename from docs/TESTING.md rename to docs/testing.md