Почему в вашем коде так сложно разобраться

Эта статья маст хэв для новичков.

Я разделяю проект на модули когда кода или сущностей становится много. Новую задачу начинаю с комментария с текстом задачи и шагами решения. Дальше под каждый шаг пишу метод. Если метод парсит или строит какой-то текст то в комментарии пишу пример. Сам метод начинаю с написания todo-шек. Имена методов и переменных всегда говорят о содержании.

Это пришло с опытом. Будучи студентом страдал отсутствием комментов и всё пихал в один файл :)