🪐 Как я раньше прятал документацию

Когда мы только начали разрабатывать наш продукт — в далёком 2014 году — я боялся выкладывать документацию в открытый доступ.

Боялся лишних вопросов от тех, кто ещё не купил. Боялся, что конкуренты подглядят и унесут идеи. Боялся, что документация отпугнёт, если человек попадёт не в ту статью, если не поймёт термины, если увидит недоработки.

Я искренне считал, что её нужно давать только по запросу и только после покупки. Словно это часть какого-то внутреннего механизма, который нужно прятать до сделки.

Мы писали документацию скупо. Не публиковали её онлайн. Не делали версий. И даже потенциальным клиентам высылали её неохотно — только по запросу, через менеджера, в виде PDF.

Сначала выходил релиз, и только потом, через время, появлялась документация. Если появлялась. Продукт развивался, а документация отставала. Мы не вели историю изменений, не синхронизировали версии, и порой сами не были уверены, насколько актуален тот или иной текст.

Со временем я понял: документация не мешает — она помогает. Не пугает — а убеждает. Не раскрывает слабости — а демонстрирует зрелость.

И главное — она не мешает продажам, а усиливает доверие. Потому что открытость — это тоже клиентоцентричность. Когда ты не прячешься, не ждёшь запроса, не фильтруешь доступ — а просто показываешь, как всё работает, на языке клиента.

В какой-то момент мы приняли решение: перестроить документацию с нуля. Мы сделали её неотъемлемой частью разработки продукта. Теперь всё собрано в одном месте — без хаоса из PDF, Word-файлов и заметок на салфетках. Вся история изменений хранится в git. А вместо устаревших архивов — живой сайт, не музей, а интерактивная платформа, которая развивается вместе с продуктом!

О том, как она устроена — расскажу в следующем посте.

#мыслиCEOвслух