Я пока только учусь, но заметил, что главное — не писать кучей громоздких функций, а делить задачи на маленькие и понятные части. Имена переменных действительно помогают не запутаться, особенно когда возвращаешься к коду спустя время. Комментарии стараюсь писать не про то, что делает код, а почему именно так сделал — вроде помогает. Главное, чтоб потом самому было проще читать.