При написании кода или его рефакторинге программисты часто задаются вопросом: "А писать ли комментарии к коду?". И многие отвечают: "Да, писать!"

Я же соглашусь с Мартином Фаулером - "почувствовав потребность написать комментарий, попробуйте сначала изменить структуру кода так, чтобы любые комментарии стали излишними" (Мартин Фаулер "Рефакторинг: улучшение существующего кода").

Всегда давайте "говорящие" названия классам, методам, переменным; соблюдайте архитектуру приложения. И Ваш код станет более читабелен без комментариев

class CMSTable extends CMSRender

<?

/**
* @var CMStable $this
*
*/

$this->table_class

?>

 Leave a Reply

You may use these HTML tags and attributes: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <s> <strike> <strong>

(required)

(required)

   
© 2012 Программирование в удовольствие Яндекс.Метрика Suffusion theme by Sayontan Sinha