Статусы и редакции спецификаций
Как зафиксировать согласованную редакцию, начать новую и сравнить изменения.
Статус спецификации
Откройте требование, сущность данных, интерфейс или операцию API. В шапке проверьте ветку, статус и номер редакции. Ключ остаётся общим для всех редакций, а номер указывает на конкретное состояние записи.
| Статус | Когда использовать |
|---|---|
| Draft | Спецификация редактируется. Изменения версионируемого содержания сохраняются в текущем черновике. |
| Locked | Команда согласовала редакцию и фиксирует её для чтения. |
| Deprecated | Спецификация устарела. Её ключ и история остаются доступны для справки. |
Новая редакция после согласования
- Проверьте содержание и связи в нужной ветке. Когда команда согласует редакцию, выберите Locked в меню статуса.
- Если поведение изменится, откройте ту же запись и выберите New Revision. Проверьте, что новый черновик имеет статус Draft и прежний ключ.
- Обновите описание и связанные спецификации. После проверки зафиксируйте новую редакцию через Locked.
Если действие недоступно, проверьте права, выбранную ветку и номер открытой редакции.
Сравнение редакций
- Откройте Select revision в шапке спецификации. Для полного списка выберите Show All.
- В меню Diff Mode выберите Previous для сравнения с предыдущей редакцией или Actual для сравнения с текущей. Режим Off открывает историческую редакцию без подсветки.
- Просмотрите изменения текста и связей. Когда передаёте результат коллегам, укажите ключ, ветку и номер редакции.
