Допустим взял отпуск на месяц и в течение месяца вообще не садишься за комп и не пишешь проект.
Как спустя месяц снова быстро влиться в свой собственный код, если его дофига ? Бывает такое, что приходится часа полтора сидеть и разбирать собственный код. Выявлять "концы" и т.д.
А как вы решаете такую проблему? Как правильно ставить на паузу разработку, чтобы не запутаться спустя месяц в собственном коде?
"Я через месяц отпуска" — то же, что "другой, новый разработчик в проекте".
Смотрю на свой код, как будто его завтра будет допиливать другой разраб, пока я вне зоны доступа.
Стараюсь придерживаться общепринятых паттернов, комментировать моменты, требующие пояснения. Коммитить раз в день или чаще по завершенным микрозадачам, с разумными комментами коммитов.
К уже сказанному Сергей Горностаев стоит добавить что надо обязательно делить работу на части, которые доводить до конца. Если у вас есть не завершенные части то уже через несколько дней даже при наличии документации вы о них забудете
Использую ООП для построения "дерева" зависимостей и "простыню" для data work-flow.
Комментирую секции, отвечающие за логику обработки потока данных и разные редко встерчающиеся неявные операции, если таковые есть (например, специфичные сложные условия или этажерки возврата объектов).
Комментировать библиотеки или классы - смысла нет.
Всю логику верхнего уровня храню в одном файле и с него начинаю просмотр: сразу всё в голове "вырисоввывается" в плане происходящего с данными: зависимости, вызовы/обращения и т.п.
Если что-то не дописал и надолго нужно отложить: ставлю или ошибку компиляции с комментом над ней или рейзю/прерываю и вывожу мессагу для себя.
