История изменений
Исправление TEX, (текущая версия) :
А почему бы не называть функции так, чтобы было понятно что они делают?
Эм... а нафига из достаточно короткого и английского названия функции догадываться что она делать и что она не делает ? Мне либой нужно пользоваться, а не изучать хитросплетения её кода и наименований функций. В твоем примере кстати шапки над функциями тоже есть. Видать не хватила имени то.
Документация и комментарии это наверное всё-таки разные вещи.
Именно в этом я не согласен с Eddy_Em. Шапка к функции или классу - не есть комментарий к коду, это суть документация как она есть. А комментарий к коду - да должен быть прост и лаконичен
Исходная версия TEX, :
А почему бы не называть функции так, чтобы было понятно что они делают?
Эм... а нафига из достаточно короткого и английского названия функции догадываться что она делать и что она не делает ? Мне либо нужно пользоваться, а не изучать хитросплетения её кода и наименований функций. В твоем примере кстати шапки над функциями тоже есть. Видать не хватила имени то.
Документация и комментарии это наверное всё-таки разные вещи.
Именно в этом я не согласен с Eddy_Em. Шапка к функции или классу - не есть комментарий к коду, это суть документация как она есть. А комментарий к коду - да должен быть прост и лаконичен