П
Слабый разраб не знает то, что запрогал сильный(
Size: a a a
2021 April 11
ЕК
В любом случае если условно за пол года активных действий не получилось изменить ситуацию - встает вопрос оправданности тратить свои силы и время на то что бы пытаться дальше
П
Тем более что часто они приходят после и изучают уже готовую систему
ЕК
Ну вот пока изучают - пусть и пишут заодно) Свежим незамыленным взглядом)
ЕК
Заодно и проблемы опишут, которые старички уже не видят
ЕК
Я вот пришел в проект и по уже существующему коду пока разбирался доку писал, норм практика
П
Пока так и пытаемся делать, но такое описание тоже часто не точное. Упускаются неочевидные моменты, отчего дока становится капитанским пересказом кода
V
А зачем ты писал доку? Какая цель была?
П
Я тоже так делал, но мне чет стыдно это потом людям показывать
ЕК
Сложная неочевидная в работе утилита потребовалась в задаче. Вначале понял как работает, коллег спрашивал. Потом попросил руководитель написать - чел который писал на другом проекте уже
V
Ну то бишь для себя, да? Чтоб лучше понять
ЕК
Нет, не для себя) Для следующих поколений) Но мне не сложно - я уже разобрался, понял как что работает)
ЕК
Но для себя - хорошая практика)
V
Понял, спасибо. Тут проблему вижу в том, что неясно, как оценить — понятно ли для других написал
V
Точно так.
ЕК
Есть такая проблема) Я уверен что достаточно хорошо, но это потому что я такой крутой 😎
V
Да даже для себя писать — офигенно :)
V
А там и поменторить кого можно будет по материалу уже попробовать
ЕК
Ну тут есть момент - если пишешь только для себя, ты пишешь доку в контексте твоих знаний, которые читающий может не знать.
V
Все так :)