И таких доков много

ого, он ещё жив!

В смысле есть живые люди, которые его используют

Ребят, привет. Помогите продать бизнесу идею ведения продуктовой документации. Текущее состояние - отдел тестирования пишет test case в своей табличке по фугкционалу, который они тестируют. Требования описаны в задачах в jira. Общее продуктовой понимание - раскидано по ПМ разных команд. Команд ~5. Т.е. цельной картины нет ни у кого.

Я вижу следующие проблемы -
- разрозненность знаний по проекту
- нет единого информационного окна

Так как ситуаций, в которых бы помогла документация - слишком мало, то для бизнеса это не проблемы, и он не готов тратить дополнительные ресурсы на ее ведение…

Какие бизнес-задачи решит ведение продуктовой документации?

- все будут знать, как работает продукт - меньше отвлечения людей, у которых есть эти знания
- при возникновении вопросов - почему это работает именнено так - ответ будет в доках

это наверное единственное, что сходу приходит в голову

по идее - только экономия времени

поясни, что такое продуктовая документация? Для кого она?

Для внутренних сотрудников или для пользователей?

Привет, чят. А какой docs-as-code стек для ведения документации сейчас самый хипстерский? И каждый хотел бы начинать новые проекты именно на нём.

для внутренних

Пример - у нас есть функционал комментирования на сайте - он имеет вход через соцсети, ответы на коменты, голосования и тд.
Порой возникает вопрос - почему тот или иной комментарий показывается в топе.

Сколько часов разработчика и тестировщика, а также проджекта можно сэкономить? (ориентировочно)

Если бы у меня были описаны все механики данного функционала - то тогда вопросов бы не было. И любой (разработчик, внутренний заказчик) мог увидеть все в едином окне.

часов 20 в месяц наверное максимум

С каждого участника команды?

со всех 🙂

мда. похоже вывод - это не нужно

На онбординг заложили?

не так часто приходят новые сотрудники. Раз в 2 квартала примерно - 1 человек. Текучка маленькая…

Хипстерский, пожалуй, Gatsby, но начинать новые проекты я хочу как и раньше на Sphinx, потому что он всё равно лучше для моих задач ))

Вообще, всё сильно зависит от задачи и требований. Какой объём доки, есть ли локализация, есть ли версии, нужно ли автогенерить часть доки из кода, какие выходные форматы нужны.