Это все оффтоп, но тем не менее отвечу.
Цитата(_Артём_ @ Oct 9 2012, 00:32)

Как его нужно составлять чтобы код самодокументировался?
Вообще-то этому посвящены целые труды, например:
Роберт Мартин, "Чистый код".
Ален И. Голуб, "ВЕРЕВКА ДОСТАТОЧНОЙ ДЛИНЫ, ЧТОБЫ ВЫСТРЕЛИТЬ СЕБЕ В НОГУ"
Вообще, правило одно, а звучит оно очень просто: "код должен читаться так, как читается хорошая книга".
Однако, это не так-то легко осуществить...
Цитата
Какие лучше программы использовать для этого?
Проги тут вряд ли помогут, а, скорее, без должного опыта только навредят:
давно замечено, что ребёнки, которые много учаться ходить с помощью "ходунков",
несколько позже других детей осваивают самостоятельную ходьбу.
Впрочем, без посторонней помощи они это делают тоже дольше ...
Цитата
Комметарии тоже сворачиваются.
С сокращений и начинается в коде срач, который потом невероятно трудно сопровождать. Особенно другому человеку.
Вопрос риторический: вы в книгах очень любите сокращения?
Цитата
Невелик труд.
Малый труд - тоже труд. Я предпочитаю по-быть в этому случае лентяем - вообще не переключать раскладку

Цитата
к тому же текст на родном языке лучше воспринимается.
Со временем эта грань стирается - потом уже не замечаешь разницы