Как фиксировать изменения
Новые требования появляются регулярно, поэтому каждое изменение должно оставлять след в документации.
Минимальный процесс
- Зафиксировать требование в журнале требований.
- Указать источник: кто попросил, когда и в каком контексте.
- Описать текущее поведение и желаемое поведение.
- Отметить затронутые роли, страницы и процессы.
- Принять решение: реализуем, откладываем, уточняем или отменяем.
- После реализации обновить пользовательскую страницу, процесс и матрицу доступов.
- Проверить сборку документации.
Что обязательно указать
| Поле | Зачем нужно |
|---|---|
| Дата | чтобы понимать порядок решений |
| Источник | чтобы знать, у кого уточнять детали |
| Статус | чтобы отличать согласованное от черновика |
| Затронутые роли | чтобы не потерять доступы |
| Затронутые процессы | чтобы не сломать цепочку задач |
| Критерии приемки | чтобы разработчик и заказчик одинаково понимали результат |
Когда обновлять документацию
Документация обновляется вместе с изменением системы. Если задача разработки меняет поведение, но документация не изменена, изменение считается не полностью закрытым.
Особенно важно обновлять:
- страницы задач и процессов;
- страницы сущностей с полями и правами;
- Права в ИС;
- пользовательские инструкции;
- журнал требований.