Разрабы чаще комментарии в коде писать не хотят, а тут наоборот)

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

Эскалируй своему манагеру

Мы с ним оба манагеры 😆 надо между собой разбираться, выше уже вальдшнепы и лебеди

Все равно кто вы, речь о твоём непосредственном руководстве. Их задача разруливать такие ситуации

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

Думаю, неплохо ещё понемногу искать новую контору

Не, контора меня устраивает. Объяснение как, например, объясняется почему видео гайды не являются документацией, но для комментов и кода, мне бы подошло

Комменты кода это о документация все же, и таковой она называется в англоязычных источниках

Но не об аналитической, это не ТЗ, не спеки, не описание бизнес-процессов и тд

Привет))

Комментарии к коду документация? Да. Нужно ли это делать? Определённо, где-то даже обязательно по норм.требованиям. А вот почему менеджер пытается по коду понять требования?? Ерунда какая-то. В коде может быть что угодно и один и тот же код может закрывать совершенно разные условия и требования, универсально применяться. Тут можно только алгоритм, принципы взаимодействия вытащить. А вот что менеджеры хотят совсем не понятно

если если браузер пристыковать к правому краю экрана, а к левому — мсворд… поэтому экран не пишем. Чаще всего «страница», иногда — «форма»

первый вариант для продуктовой компании не имеет смысла. Она не проекты сдает, а создает продукт. И сама решает, что нужно, чтобы этот продукт покупали. На рынке, а не по госзакупкам и тендерам с каким-то там ТЗ

тут наложение контекстов, для разработчиков документация только и ограничивается комментами кода в узком смысле

Страшно глючит опрос. Сначала вообще не отображался, теперь показывает то результаты, то кнопки ответа.

А зачем вы восстанавливаете требования после реализации? Чтобы видеть общую картину, а потом нормальным образом дополнять эти требования для доработок, верно? Или дальнейшие требования для доработок тоже будут вытекать  из головы лида?

Коллеги, хочется ваших мнений
Друг работает в госконторе, где много технической документации, но пишут ее до сих пор в ворде и пересылают друг другу по почте)
Хочет попробовать продавить что-то более современное. Какой вариант вам кажется оптимальным? С учетом того что вся структура тугая и человеческих ресурсов недостаточно?
Он наслушался от меня про комплект DITA+git, но мне кажется что это слишком мощное изменение, которое им не потянуть так сразу.

SVN

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

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