Обычно помимо комментов пишут тех. документацию, вот в ней и подробные описания и картинки с диаграммками. А комментарии на то и комментарии, чтобы сделать краткую заметку для тех кто будет код просматривать (обычно неизвестно в каком редакторе).

__________________
Я отдал бы немало за пару крыльев,
Я отдал бы немало за третий глаз
За руку на которой четырнадцать пальцев
Мне нужен для дыхания другой газ..

Мой блог:http://qwazar.ru/.