From f5659be0476de396246c0027274f7f2f348ec4a0 Mon Sep 17 00:00:00 2001 From: Evgenij I Date: Fri, 10 Apr 2026 00:13:13 +0300 Subject: [PATCH] i18n(uk): translate 07-plugins devops-automation & documentation - Translate READMEs, commands, agents for both plugins - Code/config/hooks files unchanged (no translation needed) Ref: luongnv89/claude-howto#63 --- uk/07-plugins/devops-automation/README.md | 100 +++++++-------- .../agents/alert-analyzer.md | 16 +-- .../agents/deployment-specialist.md | 16 +-- .../agents/incident-commander.md | 16 +-- .../devops-automation/commands/deploy.md | 18 +-- .../devops-automation/commands/incident.md | 20 +-- .../devops-automation/commands/rollback.md | 16 +-- .../devops-automation/commands/status.md | 18 +-- uk/07-plugins/documentation/README.md | 118 +++++++++--------- .../documentation/agents/api-documenter.md | 16 +-- .../documentation/agents/code-commentator.md | 16 +-- .../documentation/agents/example-generator.md | 16 +-- .../commands/generate-api-docs.md | 18 +-- .../documentation/commands/generate-readme.md | 18 +-- .../documentation/commands/sync-docs.md | 16 +-- .../documentation/commands/validate-docs.md | 16 +-- 16 files changed, 227 insertions(+), 227 deletions(-) diff --git a/uk/07-plugins/devops-automation/README.md b/uk/07-plugins/devops-automation/README.md index d0226bd..652b380 100644 --- a/uk/07-plugins/devops-automation/README.md +++ b/uk/07-plugins/devops-automation/README.md @@ -3,105 +3,105 @@ Claude How To -# DevOps Automation Plugin +# Плагін DevOps Automation -Complete DevOps automation for deployment, monitoring, and incident response. +Повна автоматизація DevOps для розгортання, моніторингу та реагування на інциденти. -## Features +## Функції -✅ Automated deployments -✅ Rollback procedures -✅ System health monitoring -✅ Incident response workflows -✅ Kubernetes integration +✅ Автоматизовані розгортання +✅ Процедури відкату +✅ Моніторинг стану системи +✅ Робочі процеси реагування на інциденти +✅ Інтеграція з Kubernetes -## Installation +## Встановлення ```bash /plugin install devops-automation ``` -## What's Included +## Що включено -### Slash Commands -- `/deploy` - Deploy to production or staging -- `/rollback` - Rollback to previous version -- `/status` - Check system health -- `/incident` - Handle production incidents +### Слеш-команди +- `/deploy` — Розгортання на продакшен або стейджинг +- `/rollback` — Відкат до попередньої версії +- `/status` — Перевірка стану системи +- `/incident` — Обробка інцидентів на продакшені -### Subagents -- `deployment-specialist` - Deployment operations -- `incident-commander` - Incident coordination -- `alert-analyzer` - System health analysis +### Субагенти +- `deployment-specialist` — Операції розгортання +- `incident-commander` — Координація інцидентів +- `alert-analyzer` — Аналіз стану системи -### MCP Servers -- Kubernetes integration +### MCP-сервери +- Інтеграція з Kubernetes -### Scripts -- `deploy.sh` - Deployment automation -- `rollback.sh` - Rollback automation -- `health-check.sh` - Health check utilities +### Скрипти +- `deploy.sh` — Автоматизація розгортання +- `rollback.sh` — Автоматизація відкату +- `health-check.sh` — Утиліти перевірки стану -### Hooks -- `pre-deploy.js` - Pre-deployment validation -- `post-deploy.js` - Post-deployment tasks +### Хуки +- `pre-deploy.js` — Передрозгортальна валідація +- `post-deploy.js` — Післярозгортальні завдання -## Usage +## Використання -### Deploy to Staging +### Розгортання на стейджинг ``` /deploy staging ``` -### Deploy to Production +### Розгортання на продакшен ``` /deploy production ``` -### Rollback +### Відкат ``` /rollback production ``` -### Check Status +### Перевірка стану ``` /status ``` -### Handle Incident +### Обробка інциденту ``` /incident ``` -## Requirements +## Вимоги - Claude Code 1.0+ - Kubernetes CLI (kubectl) -- Cluster access configured +- Налаштований доступ до кластера -## Configuration +## Конфігурація -Set up your Kubernetes config: +Налаштуйте конфіг Kubernetes: ```bash export KUBECONFIG=~/.kube/config ``` -## Example Workflow +## Приклад робочого процесу ``` User: /deploy production Claude: -1. Runs pre-deploy hook (validates kubectl, cluster connection) -2. Delegates to deployment-specialist subagent -3. Runs deploy.sh script -4. Monitors deployment progress via Kubernetes MCP -5. Runs post-deploy hook (waits for pods, smoke tests) -6. Provides deployment summary +1. Запускає pre-deploy хук (валідація kubectl, з'єднання з кластером) +2. Делегує субагенту deployment-specialist +3. Запускає скрипт deploy.sh +4. Моніторить прогрес розгортання через Kubernetes MCP +5. Запускає post-deploy хук (очікування подів, smoke-тести) +6. Надає підсумок розгортання -Result: -✅ Deployment complete -📦 Version: v2.1.0 -🚀 Pods: 3/3 ready -⏱️ Time: 2m 34s +Результат: +✅ Розгортання завершено +📦 Версія: v2.1.0 +🚀 Поди: 3/3 готові +⏱️ Час: 2хв 34с ``` diff --git a/uk/07-plugins/devops-automation/agents/alert-analyzer.md b/uk/07-plugins/devops-automation/agents/alert-analyzer.md index d455e24..cea8b9f 100644 --- a/uk/07-plugins/devops-automation/agents/alert-analyzer.md +++ b/uk/07-plugins/devops-automation/agents/alert-analyzer.md @@ -1,14 +1,14 @@ --- name: alert-analyzer -description: Analyzes monitoring alerts and system metrics +description: Аналізує алерти моніторингу та метрики системи tools: read, grep, bash --- -# Alert Analyzer +# Аналізатор алертів -Analyzes system health and alerts: -- Alert correlation -- Trend analysis -- Root cause identification -- Metric visualization -- Proactive issue detection +Аналізує стан системи та алерти: +- Кореляція алертів +- Аналіз трендів +- Визначення першопричини +- Візуалізація метрик +- Проактивне виявлення проблем diff --git a/uk/07-plugins/devops-automation/agents/deployment-specialist.md b/uk/07-plugins/devops-automation/agents/deployment-specialist.md index 47fe3f7..4871c26 100644 --- a/uk/07-plugins/devops-automation/agents/deployment-specialist.md +++ b/uk/07-plugins/devops-automation/agents/deployment-specialist.md @@ -1,14 +1,14 @@ --- name: deployment-specialist -description: Handles all deployment operations +description: Обробляє всі операції розгортання tools: read, write, bash, grep --- -# Deployment Specialist +# Спеціаліст з розгортання -Expert in deployment operations: -- Blue-green deployments -- Canary releases -- Rollback procedures -- Health checks -- Database migrations +Експерт з операцій розгортання: +- Blue-green розгортання +- Канаркові релізи +- Процедури відкату +- Перевірки стану +- Міграції бази даних diff --git a/uk/07-plugins/devops-automation/agents/incident-commander.md b/uk/07-plugins/devops-automation/agents/incident-commander.md index d73929c..4610d7a 100644 --- a/uk/07-plugins/devops-automation/agents/incident-commander.md +++ b/uk/07-plugins/devops-automation/agents/incident-commander.md @@ -1,14 +1,14 @@ --- name: incident-commander -description: Coordinates incident response +description: Координує реагування на інциденти tools: read, write, bash, grep --- -# Incident Commander +# Командир інцидентів -Manages incident response: -- Severity assessment -- Team coordination -- Status updates -- Resolution tracking -- Post-mortem facilitation +Керує реагуванням на інциденти: +- Оцінка серйозності +- Координація команди +- Оновлення статусу +- Відстеження розв'язання +- Фасилітація post-mortem diff --git a/uk/07-plugins/devops-automation/commands/deploy.md b/uk/07-plugins/devops-automation/commands/deploy.md index 4873ca3..e8a5dba 100644 --- a/uk/07-plugins/devops-automation/commands/deploy.md +++ b/uk/07-plugins/devops-automation/commands/deploy.md @@ -1,15 +1,15 @@ --- name: Deploy -description: Deploy application to production or staging +description: Розгортання застосунку на продакшен або стейджинг --- -# Deploy Application +# Розгортання застосунку -Execute deployment workflow: +Виконання робочого процесу розгортання: -1. Run pre-deployment checks -2. Build application -3. Run tests -4. Deploy to target environment -5. Run health checks -6. Notify team on Slack +1. Запуск передрозгортальних перевірок +2. Збірка застосунку +3. Запуск тестів +4. Розгортання на цільове середовище +5. Запуск перевірок стану +6. Повідомлення команди в Slack diff --git a/uk/07-plugins/devops-automation/commands/incident.md b/uk/07-plugins/devops-automation/commands/incident.md index b5c0459..a20dbd3 100644 --- a/uk/07-plugins/devops-automation/commands/incident.md +++ b/uk/07-plugins/devops-automation/commands/incident.md @@ -1,16 +1,16 @@ --- name: Incident Response -description: Handle production incidents with structured response +description: Обробка інцидентів на продакшені зі структурованим реагуванням --- -# Incident Response +# Реагування на інциденти -Structured incident response workflow: +Структурований процес реагування на інциденти: -1. Create incident record -2. Assess severity and impact -3. Notify on-call team -4. Gather diagnostic information -5. Coordinate response efforts -6. Document resolution -7. Schedule post-mortem +1. Створення запису інциденту +2. Оцінка серйозності та впливу +3. Повідомлення чергової команди +4. Збір діагностичної інформації +5. Координація зусиль з реагування +6. Документування розв'язання +7. Планування post-mortem diff --git a/uk/07-plugins/devops-automation/commands/rollback.md b/uk/07-plugins/devops-automation/commands/rollback.md index 2eb20a3..d8998b2 100644 --- a/uk/07-plugins/devops-automation/commands/rollback.md +++ b/uk/07-plugins/devops-automation/commands/rollback.md @@ -1,14 +1,14 @@ --- name: Rollback -description: Rollback to previous deployment +description: Відкат до попереднього розгортання --- -# Rollback Deployment +# Відкат розгортання -Rollback to previous stable version: +Відкат до попередньої стабільної версії: -1. Identify previous deployment -2. Verify rollback target is healthy -3. Execute rollback procedure -4. Run health checks -5. Notify team +1. Визначення попереднього розгортання +2. Перевірка працездатності цілі відкату +3. Виконання процедури відкату +4. Запуск перевірок стану +5. Повідомлення команди diff --git a/uk/07-plugins/devops-automation/commands/status.md b/uk/07-plugins/devops-automation/commands/status.md index 6c2e670..3b8b2a7 100644 --- a/uk/07-plugins/devops-automation/commands/status.md +++ b/uk/07-plugins/devops-automation/commands/status.md @@ -1,15 +1,15 @@ --- name: System Status -description: Check overall system health and status +description: Перевірка загального стану та працездатності системи --- -# System Status Check +# Перевірка стану системи -Check system health across all services: +Перевірка стану системи по всіх сервісах: -1. Query Kubernetes pod status -2. Check database connections -3. Monitor API response times -4. Review error rates -5. Check resource utilization -6. Report overall health +1. Запит статусу подів Kubernetes +2. Перевірка з'єднань з базою даних +3. Моніторинг часу відповіді API +4. Перегляд частоти помилок +5. Перевірка використання ресурсів +6. Звіт про загальний стан diff --git a/uk/07-plugins/documentation/README.md b/uk/07-plugins/documentation/README.md index 0934147..2f07044 100644 --- a/uk/07-plugins/documentation/README.md +++ b/uk/07-plugins/documentation/README.md @@ -3,117 +3,117 @@ Claude How To -# Documentation Plugin +# Плагін Documentation -Comprehensive documentation generation and maintenance for your project. +Комплексна генерація та підтримка документації для вашого проєкту. -## Features +## Функції -✅ API documentation generation -✅ README creation and updates -✅ Documentation synchronization -✅ Code comment improvements -✅ Example generation +✅ Генерація API-документації +✅ Створення та оновлення README +✅ Синхронізація документації +✅ Покращення коментарів коду +✅ Генерація прикладів -## Installation +## Встановлення ```bash /plugin install documentation ``` -## What's Included +## Що включено -### Slash Commands -- `/generate-api-docs` - Generate API documentation -- `/generate-readme` - Create or update README -- `/sync-docs` - Sync docs with code changes -- `/validate-docs` - Validate documentation +### Слеш-команди +- `/generate-api-docs` — Генерація API-документації +- `/generate-readme` — Створення або оновлення README +- `/sync-docs` — Синхронізація документації зі змінами коду +- `/validate-docs` — Валідація документації -### Subagents -- `api-documenter` - API documentation specialist -- `code-commentator` - Code comment improvements -- `example-generator` - Code example creation +### Субагенти +- `api-documenter` — Спеціаліст з API-документації +- `code-commentator` — Покращення коментарів коду +- `example-generator` — Створення прикладів коду -### Templates -- `api-endpoint.md` - API endpoint documentation template -- `function-docs.md` - Function documentation template -- `adr-template.md` - Architecture Decision Record template +### Шаблони +- `api-endpoint.md` — Шаблон документації ендпоінту API +- `function-docs.md` — Шаблон документації функції +- `adr-template.md` — Шаблон Architecture Decision Record -### MCP Servers -- GitHub integration for documentation syncing +### MCP-сервери +- Інтеграція з GitHub для синхронізації документації -## Usage +## Використання -### Generate API Documentation +### Генерація API-документації ``` /generate-api-docs ``` -### Create README +### Створення README ``` /generate-readme ``` -### Sync Documentation +### Синхронізація документації ``` /sync-docs ``` -### Validate Documentation +### Валідація документації ``` /validate-docs ``` -## Requirements +## Вимоги - Claude Code 1.0+ -- GitHub access (optional) +- Доступ до GitHub (опціонально) -## Example Workflow +## Приклад робочого процесу ``` User: /generate-api-docs Claude: -1. Scans all API endpoints in /src/api/ -2. Delegates to api-documenter subagent -3. Extracts function signatures and JSDoc -4. Organizes by module/endpoint -5. Uses api-endpoint.md template -6. Generates comprehensive markdown docs -7. Includes curl, JavaScript, and Python examples +1. Сканує всі API-ендпоінти в /src/api/ +2. Делегує субагенту api-documenter +3. Витягує сигнатури функцій та JSDoc +4. Організує за модулями/ендпоінтами +5. Використовує шаблон api-endpoint.md +6. Генерує комплексну markdown-документацію +7. Включає приклади curl, JavaScript та Python -Result: -✅ API documentation generated -📄 Files created: +Результат: +✅ API-документація згенерована +📄 Створені файли: - docs/api/users.md - docs/api/auth.md - docs/api/products.md -📊 Coverage: 23/23 endpoints documented +📊 Покриття: 23/23 ендпоінти задокументовано ``` -## Templates Usage +## Використання шаблонів -### API Endpoint Template -Use for documenting REST API endpoints with full examples. +### Шаблон ендпоінту API +Використовуйте для документування REST API ендпоінтів з повними прикладами. -### Function Documentation Template -Use for documenting individual functions/methods. +### Шаблон документації функції +Використовуйте для документування окремих функцій/методів. -### ADR Template -Use for documenting architectural decisions. +### Шаблон ADR +Використовуйте для документування архітектурних рішень. -## Configuration +## Конфігурація -Set up GitHub token for documentation syncing: +Налаштуйте GitHub-токен для синхронізації документації: ```bash export GITHUB_TOKEN="your_github_token" ``` -## Best Practices +## Найкращі практики -- Keep documentation close to code -- Update docs with code changes -- Include practical examples -- Validate regularly -- Use templates for consistency +- Тримайте документацію близько до коду +- Оновлюйте документацію разом зі змінами коду +- Включайте практичні приклади +- Регулярно валідуйте +- Використовуйте шаблони для консистентності diff --git a/uk/07-plugins/documentation/agents/api-documenter.md b/uk/07-plugins/documentation/agents/api-documenter.md index 487c5a4..50848fc 100644 --- a/uk/07-plugins/documentation/agents/api-documenter.md +++ b/uk/07-plugins/documentation/agents/api-documenter.md @@ -1,14 +1,14 @@ --- name: api-documenter -description: API documentation specialist +description: Спеціаліст з API-документації tools: read, write, grep --- -# API Documenter +# API-документатор -Creates comprehensive API documentation: -- Endpoint documentation -- Parameter descriptions -- Response schemas -- Code examples (curl, JS, Python) -- Error codes +Створює комплексну API-документацію: +- Документація ендпоінтів +- Описи параметрів +- Схеми відповідей +- Приклади коду (curl, JS, Python) +- Коди помилок diff --git a/uk/07-plugins/documentation/agents/code-commentator.md b/uk/07-plugins/documentation/agents/code-commentator.md index a039443..9d01e52 100644 --- a/uk/07-plugins/documentation/agents/code-commentator.md +++ b/uk/07-plugins/documentation/agents/code-commentator.md @@ -1,14 +1,14 @@ --- name: code-commentator -description: Code comment and inline documentation specialist +description: Спеціаліст з коментарів коду та інлайн-документації tools: read, write, edit --- -# Code Commentator +# Коментатор коду -Improves code documentation: -- JSDoc/docstring comments -- Inline explanations -- Parameter descriptions -- Return type documentation -- Usage examples +Покращує документацію коду: +- JSDoc/docstring коментарі +- Інлайн-пояснення +- Описи параметрів +- Документація типів повернення +- Приклади використання diff --git a/uk/07-plugins/documentation/agents/example-generator.md b/uk/07-plugins/documentation/agents/example-generator.md index 1cd1c7e..59a5800 100644 --- a/uk/07-plugins/documentation/agents/example-generator.md +++ b/uk/07-plugins/documentation/agents/example-generator.md @@ -1,14 +1,14 @@ --- name: example-generator -description: Code example and tutorial specialist +description: Спеціаліст з прикладів коду та туторіалів tools: read, write --- -# Example Generator +# Генератор прикладів -Creates practical code examples: -- Getting started guides -- Common use cases -- Integration examples -- Best practices -- Troubleshooting scenarios +Створює практичні приклади коду: +- Гайди початку роботи +- Поширені сценарії використання +- Приклади інтеграції +- Найкращі практики +- Сценарії усунення проблем diff --git a/uk/07-plugins/documentation/commands/generate-api-docs.md b/uk/07-plugins/documentation/commands/generate-api-docs.md index a5bda46..4ca0f77 100644 --- a/uk/07-plugins/documentation/commands/generate-api-docs.md +++ b/uk/07-plugins/documentation/commands/generate-api-docs.md @@ -1,15 +1,15 @@ --- name: Generate API Documentation -description: Generate comprehensive API documentation from source code +description: Генерація комплексної API-документації з вихідного коду --- -# API Documentation Generator +# Генератор API-документації -Generate complete API documentation: +Генерація повної API-документації: -1. Scan API endpoints -2. Extract function signatures and JSDoc -3. Organize by module/endpoint -4. Create markdown with examples -5. Include request/response schemas -6. Add error documentation +1. Сканування API-ендпоінтів +2. Витягування сигнатур функцій та JSDoc +3. Організація за модулями/ендпоінтами +4. Створення markdown з прикладами +5. Включення схем запитів/відповідей +6. Додавання документації помилок diff --git a/uk/07-plugins/documentation/commands/generate-readme.md b/uk/07-plugins/documentation/commands/generate-readme.md index 119310a..23e8e60 100644 --- a/uk/07-plugins/documentation/commands/generate-readme.md +++ b/uk/07-plugins/documentation/commands/generate-readme.md @@ -1,15 +1,15 @@ --- name: Generate README -description: Create or update project README +description: Створення або оновлення README проєкту --- -# README Generator +# Генератор README -Generate comprehensive README: +Генерація комплексного README: -1. Project overview and description -2. Installation instructions -3. Usage examples -4. API documentation links -5. Contributing guidelines -6. License information +1. Огляд та опис проєкту +2. Інструкції з встановлення +3. Приклади використання +4. Посилання на API-документацію +5. Настанови для контриб'юторів +6. Інформація про ліцензію diff --git a/uk/07-plugins/documentation/commands/sync-docs.md b/uk/07-plugins/documentation/commands/sync-docs.md index 9681cc8..795966d 100644 --- a/uk/07-plugins/documentation/commands/sync-docs.md +++ b/uk/07-plugins/documentation/commands/sync-docs.md @@ -1,14 +1,14 @@ --- name: Sync Documentation -description: Sync documentation with code changes +description: Синхронізація документації зі змінами коду --- -# Documentation Sync +# Синхронізація документації -Synchronize documentation with codebase: +Синхронізація документації з кодовою базою: -1. Detect code changes -2. Identify outdated documentation -3. Update affected docs -4. Verify examples still work -5. Update version numbers +1. Виявлення змін коду +2. Визначення застарілої документації +3. Оновлення уражених документів +4. Перевірка працездатності прикладів +5. Оновлення номерів версій diff --git a/uk/07-plugins/documentation/commands/validate-docs.md b/uk/07-plugins/documentation/commands/validate-docs.md index bd41f57..a5186db 100644 --- a/uk/07-plugins/documentation/commands/validate-docs.md +++ b/uk/07-plugins/documentation/commands/validate-docs.md @@ -1,14 +1,14 @@ --- name: Validate Documentation -description: Validate documentation for completeness and accuracy +description: Валідація документації на повноту та точність --- -# Documentation Validation +# Валідація документації -Validate documentation quality: +Перевірка якості документації: -1. Check for broken links -2. Verify code examples -3. Ensure completeness -4. Check formatting -5. Validate against actual code +1. Перевірка на зламані посилання +2. Верифікація прикладів коду +3. Забезпечення повноти +4. Перевірка форматування +5. Валідація відповідності реальному коду