Но как найти золотую середину?
Каков объем комментариев нужно размещать в скрипте?! Это зависит от множества факторов: например, времени, которое есть у вас, или сложности проекта и политики компании и т.п. Тем не менее, вам нужно усвоить некоторые основные принципы, которых следует придерживаться при написании программ:

Всегда комментируйте назначение функций перед их телом.

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

Комментируйте код строками /* */ или // и избегайте комментариев вида #.
В следующем примере наведен хороший стиль комментариев:

<?php
// Random_Numbers.lib
// Генерация случайных чисел различного типа

mt_srand((double)microtime()*1000000);

//
// mixed random_element(array $elements[, array weights])
// Возвращает случайный элемент массива-аргумента
// Массив weights содержит относительные вероятности
// выборки элементов
//

function random_element ($elements, $weights = array())
{

// Для корректного функционирования этого алгоритма
// количество элементов массива должно быть равным
// количеству элементов массива относительных вероятностей

if (count ($weights) == count ($elements)) {
foreach ($elements as $element) {
foreach ($weights as $idx) {

// Примечание: мы не используем $idx, потому что
// нам не нужен доступ к отдельным элементам
// массива weights

$randomAr[] = $element;
}
}
}
else {
$randomAr = $elements;
}

$random_element = mt_rand (0, count ($randomAr) - 1);
return $randomAr [$random_element];
}
?>

А еще вы можете хорошо заработать, вступив в форекс клуб. Forex используют всевозможные контрагенты во всем мире: банки, финансовые и промышленные организации для конвертации одной валюты, необходимой для расчетов, в другую, а так же простые люди, которые способны торгуя валютой на Форекс зарабатывать и значительно приумножать свои капиталы.