Не посчитайте, что я пытаюсь обидеть или сказать, что код плох.
Просто хочется, чтобы потом не глядя в код, не разбирая его - было понятно почему именно так было сделано.
Я не претендую на правильность комментирования, лишь показал пример, где попытался сделать более информативным код.