Здравствуйте, mrTwister, Вы писали:

T>Здравствуйте, коллеги.

T>Коментарии в коде могут решать разные задачи. В частности коментарии могут повышать читаемость кода. Но зачем повышать читаемость кода с помощью коментариев, если сам код можно структурировать таким образом, чтобы он читался легко, как книга? Для ответа на этот вопрос давайте определимся, для чего нам нужна читаемость. Итак, читаемость нам нужна, чтобы было легко понять:
T>1) Какую задачу решает код.
T>2) Каким образом код решает поставленную задачу.
T>3) Для чего потребовалось решать поставленную задачу. То есть почему этот код необходим.

Обычно, пункт 3, описывается в issue-tracker'е. Коментарии для этого, мягко говоря, не самое подходящее место.