среда, ноября 28, 2007

Кодинг: про комментирование кода

Комментирование - это неотъемлемая часть процесса программирования.
Естественно все это знают и каждый сознательный программист им занимается.
Когда я только начинал заниматься программированием объём комментариев превышал объём самого кода. Видимо это было связано с тем, что учась программировать я использовал комментарии не совсем по назначению, т.е. использовал их как средство запоминания некоторых функции, а не для указания предназначения эти функций в коде.

Например, так:
$file = fopen("file.txt"); // Функция получает указатель на файл

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

И вот заметил такую штуку за собой - я практически перестал использовать комментарии однострочные (ну тоесть комментарии справа от кода). Вот уж не знаю с чем это связано, но факт остаётся фактом, получается примерно так:

Было раньше: $file = fopen("file.txt"); // Функция получает указатель на файл
Пишу сейчас:
// Функция получает указатель на файл
$file = fopen("file.txt");

Причём делаю я это совершенно бессознательно, наверное, так глазу приятнее.

вторник, ноября 27, 2007

In the begining или как всё начиналось

Долго собирался с мыслю, взвешивал все за и против и вот решился. Начинаю вести свой блог.

Зачем? Вопрос очень интересный.
Заработать я на нем не собираюсь (хотя чем чёрт не шутит). Буду писать в него всё что посчитаю интересным, забавным, полезным.
Может комунибудь и пригодится.
О чём буду писать? Вопрос не менее интересный.
Обо всём.

Поскольку моя профессиональная деятельности связана с программированием (веб-программированием), то и подавляющая часть заметок будет именно о нём.
На данном этапе мне интересны и мною активно изучаются вездесущий PHP, Java Script, Action Script, ну и возлевитающие вещи.
Сразу оговорюсь, что опыт мой не особо велик, поэтому некоторые вещи могут показать вам слишком простыми. За что сразу же приношу свои извинения.

На этом думаю вступление можно и закончить. Но это только вступление...