SV
просто в моем понимании взять условный любой program.py\js\php\java\c\etc и сказать что он делает ну это не то чтобы оверскилл
Size: a a a
2018 July 02
S
Ser V
просто в моем понимании взять условный любой program.py\js\php\java\c\etc и сказать что он делает ну это не то чтобы оверскилл
Даже для филолога)))
S
?
НН
Нуууу, вполне себе оверскилл
НН
Ты ж техрайтер, не равняй все на свои знания
SV
да я как бы не профессор наук
SV
прочитать любой из перечисленных файлов помогает любой из бесплатных вводных курсов по нужному ЯП
SV
если там конечно специально не обфусцирован код например
SV
другой вопрос что когда там именно сборка где куча файлов с зависимостями и разобраться в архитектуре и потом это описать на доступном языке это вот уже оверскилл
SV
обратная аналитика я бы это назвал
S
Я код не читаю и научиться не смогла. Базы для этого нет) так что для меня это супер оверскил
SV
Sagi
Я код не читаю и научиться не смогла. Базы для этого нет) так что для меня это супер оверскил
по-хорошему документировать код должен или специально обученный человек или разработчик
SV
описывать бп по готовому коду это эээ плохая практика
S
Это да. Но сейчас пока частенько требуется это от техписа
SV
Sagi
Это да. Но сейчас пока частенько требуется это от техписа
доплачивают?
S
У меня не доходило дальше вопроса читаете код?))) поэтому зп не обсуждали
SV
ой там еще целый квест же, как задокументировать исходники, не все инструменты умеют работать со своим форматом файлов, а если везде писать вручную то это потом сложно собрать а если не собирать то кому нужна эта документация?
SV
Sagi
У меня не доходило дальше вопроса читаете код?))) поэтому зп не обсуждали
и все же не понятно что значит читаете код, в распределенных файлах описать не сложно, а вот взаимодействие между ними там можно утонуть в объеме информации
EN
Разработчики сами должны уметь документировать свой код, это часть их работы
НН
А вот поправить и сделать выхлоп jsdoc разумнее и читабельнее — можно