ну раз у тебя весь текст на русском - почему комментарии на английском? Вот сделаешь механизм локализации, тогда и про перевод комментариев можно подумать. 
Хорошо, подумаю над этим.
, а про дебаг нет.
Чем он тебе мешает 
Не люблю лишний текст (код) в исходнике. Он как шум в полезном сигнале, отвлекает и мешает сосредоточиться (а иногда и ошибки находить). Ладно, если бы это был какой-то монструозный скрипт или пачка скриптов, так тут скрипт небольшой да и то в нем большая часть всякие, по сути, константы обозначены, массивы. Короче говоря, было бы о чем говорить про дебуг. В этом смысле я смотрел код sysytem-report, который я до сих пор не понимаю как оно работает, хоть меня mike@ и направлял попутным ветром посмотреть, как это работает, но это уже другой уровень и я его не достиг.