Если текст программы имеет плохую документацию, это означает что разработчик – эгоистичный программист.

При анализе такой программы, чтобы внести в нее улучшения, появится излишняя головная боль. Самодокументированный код среди программистов считается хорошим тоном, но мало кто из них пишет свои комментарии.

Необходимо избегать также и избыточных комментариев. Их тоже довольно таки редко встретишь, и они создают такую же проблему – плохо читаемый исходный код. Вот наглядный пример этому:

<?php // Начало кода

$age = 18; // Возраст равен 18
$age++; // Увеличим $age на один год

// Напечатаем приветствие
print "Вам сейчас 19 лет, и это значит, что Вам уже было:";
print "\n<br>\n<br>\n";

// Цикл "для" чтобы вывести все
// предыдущие значения возраста
for ($idx = 0; $idx < $age; $idx++)
{
// Напечатаем каждое значение возраста
print "$idx лет\n<br>\n";
}
// Конец кода
?>

Для создания качественного сайта без особых проблем обратитесь к фирме СайтСтрой. Профессиональный подход к созданию сайтов для всех и каждого, вне зависимости от сложности  поставленной задачи. СайтСтрой - надежно, удобно, выгодно.