Писать или не писать документацию в стартапе

Когда только запускаешь проект — всё кажется важнее, чем документация. MVP, гипотезы, поддержка пользователей. Документация всегда «потом».

Но вот приходят новые разработчики — и тратят неделю, чтобы просто разобраться. Появляется баг — и никто не помнит, как должно было работать. И даже продуктовая гипотеза, которую провалили, остаётся без объяснения «почему так сделали».

Даже пару абзацев про то, что и зачем мы делаем — уже могут спасти ситуацию.

Какие есть варианты:

1. В Notion/Confluence — полная спека. В JIRA — задачи по реализации.

2. На каждую задачу — отдельная страница в Confluence, с ссылкой из JIRA.

Первый вариант даёт целостную картину, но быстро устаревает. Второй — проще поддерживать, но фокус теряется. В любом случае, информация устаревает. Это нормально. Стартап — это про быстрые повороты. И это надо учитывать.

Как оформлять документацию:

Или она отражает целевое состояние (куда идём — как бы «будущее»).

Или она фиксирует текущее состояние (что уже реализовано).

Если документация = «будущее», тогда это компас.
Если документация = «настоящее», тогда это карта.

Важно одно: если обновился продукт — обновилась и документация. Иначе всё быстро ломается.

А что с ресурсами?

Ресурсов нет. Ни времени, ни отдельного человека. Все работают с продуктом. Это норма.

Но даже в этом режиме можно:

- Нарисовать схему архитектуры.
- Описать направление развития.
- Сделать короткий гайд для новичков.
- Составить список ключевых задач и ссылок.

Этого хватит, чтобы:

- Снизить входной порог.
- Упростить обсуждения.
- Не теряться при смене приоритетов.

Если даже на верхнем уровне фиксировать, что мы хотели сделать и почему, — через год получится настоящая ретроспектива. Видно, какие гипотезы запускались, какие решения принимались, и как на это влияли метрики.

Получается, документация — не только «про сейчас». Это уже инструмент управления на основе данных. Источник решений. Вехи роста. Основание, чтобы объяснить выборы и избежать повторов.

Как вы подходите к документации? Или пока обходитесь без неё? Поделитесь, как у вас — интересно сравнить.