Многие мысли прям в точку! Хорошо что есть думающие люди, а то из каждого утюга "всех заменим", "я через клод написал сервис который приносит мне миллионы в наносекунду" и т.д.
Имхо. Непонятно про какую документацию речь. Например QA-шные тесткейсы из зефира хранить рядом с кодом? А подробное текстовое (человекопонятное) описание пользовательских сценариев? Много воды -- всю статью можно сократить до одного предложения "Старайтесь использовать для документации такой формат файлов который можно положить в репозиторий". У нас, например, используются подробные ридми в md-формате с описанием внешних интеграций, правил работы с кодом, инструкции как локально развернуть и т.п. в репозиториях проектов. Но пользовательская, менеждерская и QA-шная доки живут отдельно в удобных для исполнителей форматах
Многие мысли прям в точку! Хорошо что есть думающие люди, а то из каждого утюга "всех заменим", "я через клод написал сервис который приносит мне миллионы в наносекунду" и т.д.
Имхо. Непонятно про какую документацию речь. Например QA-шные тесткейсы из зефира хранить рядом с кодом? А подробное текстовое (человекопонятное) описание пользовательских сценариев? Много воды -- всю статью можно сократить до одного предложения "Старайтесь использовать для документации такой формат файлов который можно положить в репозиторий". У нас, например, используются подробные ридми в md-формате с описанием внешних интеграций, правил работы с кодом, инструкции как локально развернуть и т.п. в репозиториях проектов. Но пользовательская, менеждерская и QA-шная доки живут отдельно в удобных для исполнителей форматах