Правила ведення документації
Документація підтримується як код: матеріали зберігаються у Git-репозиторії, проходять перевірку та мають прозору історію змін.
Базові принципи
- Одна стаття — одна зрозуміла задача або тема.
- Використовуйте зрозумілі заголовки, короткі абзаци, списки й таблиці.
- Додавайте посилання на пов'язані процеси та матеріали.
- Оновлюйте документацію разом зі зміною функціональності.
- Зміни мають проходити review через Pull Request.
Перед публікацією
- Переконайтеся, що інструкція відповідає поточній версії системи.
- Перевірте посилання, назви екранів і термінологію.
- Використовуйте скріншоти лише там, де вони справді допомагають; їх потрібно підтримувати актуальними.
- Узгодьте зміни з власником відповідного розділу.