Катя Немкович PRODUCT MANAGER @ CAPTIV8.IO Мне отлично знакомо чувство паники, которое возникает, когда не понимаешь, как подступиться к документации. Что делать в первую очередь? На что нет смысла тратить время? Как поддерживать все это потом? Я расскажу о своем чеклисте, абсолютном минимуме того, что стоит делать, чтобы избежать ошеломляющих открытий в самый разгар проекта.

1. МОЙ МИНИМУМ
Катя Немкович

2. Бэкграунд
■ Внутренние требования
■ Небольшие команды
■ Продуктовая разработка
■ Нетривиальные продукты

3. 😱

4. 🤔

5. модуль
цель
функция
Логика

6. epic
story
task
Скрам

7. документ
подзаголовок
абзац
Текст

8. Как писать
■ В облаке
■ Модуль – отдельный документ
■ Зачем это надо? Какую проблему решаем? Кто будет пользоваться?
■ Абсолютный минимум слов, который достаточен для передачи смысла
(юноша с белокурыми кудрями – молодой блондин – парень)
■ В процессе вылезает куча логических дыр – заполняем
(задаем вопросы либо обходимся своим умом)
■ Консультируемся у технарей

9. Получился документ
■ Это драфт! Не привязывайтесь к нему – тысячу раз все поменяется
■ Он предназначен для согласования
■ Его недостаточно для разработки
■ Отправляем заказчику!

10. Фидбек
■ Узнаем МНОГО нового
■ Рассовываем новые детали, реструктурируем
■ Критиковать легко – с нуля этот же фидбек пришлось бы добывать сто лет
■ Чем раньше нас критикуют, тем проще это переварить
■ Если не читают или не понимают, надо визуализировать
■ С первого раза нельзя все оценить

11. НЕКОТОРАЯ
ЯСНОСТЬ

12. Бьем на спринты / версии
■ Важно узнать, что будет в следующей/первой версии, далее по вкусу:
– v.1 vs. v.2,3…
– v.1 vs. все остальное
■ Критерии разные: сроки, ресурсы, бизнес, технические зависимости
■ Функциональность версии тоже имеет смысл согласовывать со стейкхолдерами
■ После следующей версии наверняка придется дополнить все остальные – нет
смысла их сильно прорабатывать

13. Шлифовка первой версии
■ Все необходимые фичи
■ Весь возможный интерактив
■ Зависимости – ставим перекрестные ссылки

14. «Требования еще не до конца
сформулированы, но в целом все понятно,
пусть он начинает делать»
степень проработки0
БА бэкенддизайн фронтенд QA

15. Ставим таски на версию
■ Fix version / sprint
■ Таск – завершенная глагольная конструкция
■ Линкуем
■ Удобно делать графики для начальства или просто смотреть процент
выполнения

16. АТЕПЕРЬ ДОБРО
ПОЖАЛОВАТЬ В АД

17. Резюме
■ Эта работа бесконечна
■ Нельзя синхронизировать мысли, а текст кое-как можно
■ Картинки еще проще синхронизировать, чем текст, но показывать весь
интерактив дорого
■ Все равно кто-то что-то не поймет
■ Текстовые доки полезны при работе со сторонними командами, найме новичков
■ Если что-то не пропишете – все равно придут и спросят