Complete markdown documentation

docs/README.md

@@ -2,7 +2,7 @@
 
 Crank превращает REST API endpoint-ы в MCP-инструменты, которые можно подключать к AI-агентам и MCP-клиентам.
 
-Эта документация подготовлена как основа для будущего сайта. Сейчас файлы лежат в `docs/`, позже их можно перенести в Docusaurus без изменения структуры тем.
+Документация хранится в Markdown-файлах внутри `docs/` и читается прямо из репозитория.
 
 ## Начать
 
@@ -10,6 +10,7 @@ Crank превращает REST API endpoint-ы в MCP-инструменты,
 - [Установка](./installation.md)
 - [Первый инструмент](./quickstart.md)
 - [Подключение MCP-клиента](./mcp-interface.md)
+- [Практические API-примеры](./api-examples.md)
 
 ## Возможности
 
@@ -17,13 +18,15 @@ Crank превращает REST API endpoint-ы в MCP-инструменты,
 - [REST-инструменты](./protocols/rest.md)
 - [Секреты и профили авторизации](./secrets-and-auth.md)
 - [Журналы и использование](./observability.md)
+- [Проектирование MCP-инструментов](./tool-design.md)
 
 ## Справочник
 
 - [Настройки окружения](./runtime-config.md)
 - [Admin API](./admin-api.md)
 - [Развертывание](./deployment.md)
+- [Production checklist](./production-checklist.md)
+- [Troubleshooting](./troubleshooting.md)
 - [Архитектура](./architecture.md)
 - [Модель данных](./data-model.md)
 - [Тестирование](./testing-strategy.md)
-