Стоимость ревью спецификации
Структура спецификации определяет, возможно ли её серьёзное ревью.
Структура определяется стоимостью ревью
Примеры ниже показывают, как длина меняет стоимость серьёзного ревью. Это не бюджеты токенов, не уровни качества и не шаблоны для повторного использования. Количества приблизительны, и все три примера используют нейтральный текст lorem ipsum, чтобы были видны только структура и нагрузка при чтении.
У каждого примера намеренно своя структура. Реальные спецификации тоже должны различаться по структуре, если различается их неопределённость.
Около 500 токенов: компактное описание границ
Даже короткий документ способен показать замысел, ограничения, свидетельства и один нерешённый вопрос.
# Компактная спецификация
## Замысел
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nullam vulputate pulvinar nunc, sed fringilla sem posuere vel. Nunc metus eros, finibus nec rhoncus vitae, volutpat at turpis.
## Утверждения и ограничения
- Nunc auctor ultricies nunc et fermentum. Vivamus sit amet enim a est molestie posuere at non diam. Mauris pharetra ultricies tempor. Nullam laoreet risus tincidunt, semper nibh in, hendrerit metus.
- Vivamus interdum tortor at leo consequat maximus. In hac habitasse platea dictumst. Donec vitae maximus turpis, vel pulvinar nunc. Nullam nec viverra quam. Duis eget molestie velit.
- Integer ultricies felis elit, in ullamcorper risus rutrum posuere. Integer tortor nunc, molestie semper pretium id, mattis ac lorem.
- Pellentesque erat leo, posuere in tortor at, lobortis luctus dui. Quisque hendrerit ex at nulla lobortis, vel condimentum eros vestibulum.
## Свидетельства
- [ ] Etiam nec consequat dolor, nec ultrices mauris. Curabitur nec vestibulum tellus. Nulla facilisi. Nunc ut consequat nisl. Vivamus id volutpat ante, in consequat lectus.
- [ ] Etiam mollis tempor purus eget consequat. Integer nec purus quis tellus ultricies tristique vel et dui. Nam elit elit, venenatis sed felis ut.
- [ ] Sed luctus sapien id ante interdum, vel lacinia augue dignissim. Integer eget enim eu libero convallis imperdiet. Mauris suscipit vel ante id lobortis.
## Нерешённые вопросы
Mauris luctus aliquam lorem, nec mattis ex commodo sed. In laoreet tristique elit, nec congue tortor cursus nec. Donec molestie fermentum egestas. Fusce non porttitor ligula.
Около 1 тысячи токенов: больше материала для ревью
При таком объёме можно совместить сценарии и компромиссы, но рецензенту приходится удерживать в голове больше взаимосвязей.
# Документ для ревью
> Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nullam vulputate pulvinar nunc, sed fringilla sem posuere vel. Nunc metus eros, finibus nec rhoncus vitae, volutpat at turpis.
## Контекст
Duis lacinia tortor ut nibh fermentum, aliquet pellentesque erat pharetra. Vestibulum aliquet ipsum vel interdum pellentesque. Duis tincidunt sit amet augue ac ullamcorper. Phasellus nec consequat lorem. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Suspendisse vel facilisis lacus. In in enim dictum, porta mauris id, fringilla nibh.
## Заметки о решениях
1. Nunc auctor ultricies nunc et fermentum. Vivamus sit amet enim a est molestie posuere at non diam. Mauris pharetra ultricies tempor. Nullam laoreet risus tincidunt, semper nibh in, hendrerit metus.
2. Vivamus interdum tortor at leo consequat maximus. In hac habitasse platea dictumst. Donec vitae maximus turpis, vel pulvinar nunc. Nullam nec viverra quam. Duis eget molestie velit.
3. Integer ultricies felis elit, in ullamcorper risus rutrum posuere. Integer tortor nunc, molestie semper pretium id, mattis ac lorem. Sed pulvinar accumsan leo, sed blandit leo iaculis vel.
## Сценарии
### Альфа
Proin ut odio tortor. Nulla aliquet cursus leo, sit amet bibendum nisi sollicitudin at. Maecenas laoreet aliquet felis, ut volutpat odio cursus tincidunt. Nullam ac leo sit amet nulla convallis mattis.
### Бета
Etiam nec consequat dolor, nec ultrices mauris. Curabitur nec vestibulum tellus. Nulla facilisi. Nunc ut consequat nisl. Vivamus id volutpat ante, in consequat lectus. Suspendisse quis est vel nulla suscipit condimentum et ac orci. Aliquam accumsan diam enim, non varius massa sollicitudin vel.
### Гамма
Etiam mollis tempor purus eget consequat. Integer nec purus quis tellus ultricies tristique vel et dui. Nam elit elit, venenatis sed felis ut, sodales euismod purus. Ut ac ipsum ut sem euismod sagittis non non dui. Quisque eget dictum tellus. Duis egestas elit odio. Vestibulum mattis id felis ac euismod.
## Ограничения
- Duis vulputate nibh metus, quis facilisis diam feugiat nec. In facilisis metus in ante congue, eget imperdiet magna auctor.
- Aliquam erat volutpat. Suspendisse sit amet nibh non lectus dictum pretium quis commodo lorem. Nam semper diam et laoreet gravida.
- Nulla facilisi. Aliquam semper eros risus, et viverra ex ornare a. Proin a tortor mauris. Maecenas euismod magna velit.
- Mauris luctus aliquam lorem, nec mattis ex commodo sed. In laoreet tristique elit, nec congue tortor cursus nec.
## Критерии приёмки
- [ ] Fusce vestibulum nunc et enim pharetra sagittis. Fusce tortor quam, hendrerit at ultrices vel, aliquam ornare leo.
- [ ] Donec sed volutpat arcu. Sed efficitur dolor id faucibus lobortis. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas.
- [ ] Aliquam eu interdum lectus. Nulla cursus ornare sodales. Fusce feugiat dui vestibulum efficitur consectetur. Maecenas et congue mi.
## Вопросы
- Nunc auctor ultricies nunc et fermentum. Vivamus sit amet enim a est molestie posuere at non diam. Mauris pharetra ultricies tempor.
- Integer ultricies felis elit, in ullamcorper risus rutrum posuere. Integer tortor nunc, molestie semper pretium id, mattis ac lorem.
Около 2 тысяч токенов: дорогостоящая контрольная точка
Более длинный документ позволяет согласовать больше неопределённостей. Одновременно в нём сложнее заметить пропуски, противоречия и последствия поверхностного чтения. Дополнительная структура должна оправдывать эти затраты.
# Развёрнутое предложение
## Предпосылка
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nullam vulputate pulvinar nunc, sed fringilla sem posuere vel. Nunc metus eros, finibus nec rhoncus vitae, volutpat at turpis. Phasellus placerat vulputate turpis vel egestas. Curabitur lorem tortor, ultricies ut molestie at, pellentesque id ante. Nam non ullamcorper nibh. Sed feugiat, sem a feugiat eleifend, turpis mauris convallis nisi, congue pretium sem turpis id sem.
## Описание
### Условие Альфа
Duis lacinia tortor ut nibh fermentum, aliquet pellentesque erat pharetra. Vestibulum aliquet ipsum vel interdum pellentesque. Duis tincidunt sit amet augue ac ullamcorper. Phasellus nec consequat lorem. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Suspendisse vel facilisis lacus. In in enim dictum, porta mauris id, fringilla nibh.
### Условие Бета
Nunc auctor ultricies nunc et fermentum. Vivamus sit amet enim a est molestie posuere at non diam. Mauris pharetra ultricies tempor. Nullam laoreet risus tincidunt, semper nibh in, hendrerit metus.
### Условие Гамма
Vivamus interdum tortor at leo consequat maximus. In hac habitasse platea dictumst. Donec vitae maximus turpis, vel pulvinar nunc. Nullam nec viverra quam. Duis eget molestie velit.
## Границы
### Включено
- Nunc auctor ultricies nunc et fermentum. Vivamus sit amet enim a est molestie posuere at non diam. Mauris pharetra ultricies tempor. Nullam laoreet risus tincidunt, semper nibh in, hendrerit metus. Mauris sollicitudin tincidunt augue vel volutpat. Aenean elementum efficitur sapien sed laoreet.
- Integer ultricies felis elit, in ullamcorper risus rutrum posuere. Integer tortor nunc, molestie semper pretium id, mattis ac lorem. Sed pulvinar accumsan leo, sed blandit leo iaculis vel.
### Исключено
- Duis vulputate nibh metus, quis facilisis diam feugiat nec. In facilisis metus in ante congue, eget imperdiet magna auctor.
- Aliquam erat volutpat. Suspendisse sit amet nibh non lectus dictum pretium quis commodo lorem. Nam semper diam et laoreet gravida.
- Nulla facilisi. Aliquam semper eros risus, et viverra ex ornare a. Proin a tortor mauris. Maecenas euismod magna velit.
## Реестр рисков
### Риск 1
**Условие:** Fusce vestibulum nunc et enim pharetra sagittis. Fusce tortor quam, hendrerit at ultrices vel, aliquam ornare leo. Maecenas ultrices neque in mi condimentum vehicula.
**Реакция:** Donec sed volutpat arcu. Sed efficitur dolor id faucibus lobortis. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Curabitur at luctus arcu.
### Риск 2
**Условие:** Aliquam eu interdum lectus. Nulla cursus ornare sodales. Fusce feugiat dui vestibulum efficitur consectetur. Maecenas et congue mi. Nam venenatis justo enim.
**Реакция:** Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nullam vulputate pulvinar nunc, sed fringilla sem posuere vel. Nunc metus eros, finibus nec rhoncus vitae, volutpat at turpis.
### Риск 3
**Условие:** Pellentesque erat leo, posuere in tortor at, lobortis luctus dui. Quisque hendrerit ex at nulla lobortis, vel condimentum eros vestibulum. In luctus tellus metus, sit amet elementum diam imperdiet ac.
**Реакция:** Proin ut odio tortor. Nulla aliquet cursus leo, sit amet bibendum nisi sollicitudin at. Maecenas laoreet aliquet felis, ut volutpat odio cursus tincidunt. Nullam ac leo sit amet nulla convallis mattis.
## План свидетельств
### Ревью
- [ ] Etiam nec consequat dolor, nec ultrices mauris. Curabitur nec vestibulum tellus. Nulla facilisi. Nunc ut consequat nisl.
- [ ] Etiam mollis tempor purus eget consequat. Integer nec purus quis tellus ultricies tristique vel et dui. Nam elit elit, venenatis sed felis ut.
- [ ] Sed luctus sapien id ante interdum, vel lacinia augue dignissim. Integer eget enim eu libero convallis imperdiet. Mauris suscipit vel ante id lobortis.
### Проверка
- [ ] Mauris luctus aliquam lorem, nec mattis ex commodo sed. In laoreet tristique elit, nec congue tortor cursus nec.
- [ ] Nam euismod neque nec risus interdum convallis. Donec sed massa at risus consectetur imperdiet. Nam non tristique augue.
- [ ] Mauris vel dolor bibendum augue interdum posuere non ac leo. Praesent at semper elit. Nulla hendrerit nibh id tortor efficitur suscipit.
## Последовательность
1. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nullam vulputate pulvinar nunc, sed fringilla sem posuere vel. Nunc metus eros, finibus nec rhoncus vitae, volutpat at turpis. Phasellus placerat vulputate turpis vel egestas. Curabitur lorem tortor, ultricies ut molestie at.
2. Duis lacinia tortor ut nibh fermentum, aliquet pellentesque erat pharetra. Vestibulum aliquet ipsum vel interdum pellentesque. Duis tincidunt sit amet augue ac ullamcorper. Phasellus nec consequat lorem. Lorem ipsum dolor sit amet, consectetur adipiscing elit.
3. Nunc auctor ultricies nunc et fermentum. Vivamus sit amet enim a est molestie posuere at non diam. Mauris pharetra ultricies tempor. Nullam laoreet risus tincidunt, semper nibh in, hendrerit metus.
4. Vivamus interdum tortor at leo consequat maximus. In hac habitasse platea dictumst. Donec vitae maximus turpis, vel pulvinar nunc. Nullam nec viverra quam. Duis eget molestie velit.
5. Integer ultricies felis elit, in ullamcorper risus rutrum posuere. Integer tortor nunc, molestie semper pretium id, mattis ac lorem.
6. Pellentesque erat leo, posuere in tortor at, lobortis luctus dui. Quisque hendrerit ex at nulla lobortis, vel condimentum eros vestibulum.
## Запись решения
> Proin ut odio tortor. Nulla aliquet cursus leo, sit amet bibendum nisi sollicitudin at. Maecenas laoreet aliquet felis, ut volutpat odio cursus tincidunt. Nullam ac leo sit amet nulla convallis mattis.
## Нерешённые вопросы
- Etiam nec consequat dolor, nec ultrices mauris. Curabitur nec vestibulum tellus. Nulla facilisi. Nunc ut consequat nisl. Vivamus id volutpat ante, in consequat lectus. Suspendisse quis est vel nulla suscipit condimentum et ac orci. Aliquam accumsan diam enim, non varius massa sollicitudin vel.
- Etiam mollis tempor purus eget consequat. Integer nec purus quis tellus ultricies tristique vel et dui. Nam elit elit, venenatis sed felis ut, sodales euismod purus. Ut ac ipsum ut sem euismod sagittis non non dui. Quisque eget dictum tellus. Duis egestas elit odio. Vestibulum mattis id felis ac euismod.
Полезный вопрос — не «какой длины должна быть спецификация?», а «могут ли ответственные рецензенты по-прежнему понять и оспорить этот замысел?». Если нет — раздели изменение, добавь структуру или сократи документ.
Главное
- Структура определяется стоимостью ревью. Правильная спецификация — минимальный документ, сохраняющий замысел и рискованные границы. Формат, длина и процесс подготовки должны соответствовать случаю, а не каноническому шаблону.
- Длина меняет нагрузку при ревью. Компактная спецификация тоже способна показать замысел, ограничения и свидетельства. Более длинная позволяет согласовать больше неопределённостей, но пропуски и противоречия становится сложнее заметить. Дополнительная структура должна оправдывать эти затраты.
- Важны понимание рецензента, а не число токенов. Могут ли ответственные рецензенты по-прежнему понять и оспорить этот замысел? Если нет — раздели изменение, добавь структуру или сократи документ.