1

Тестовая тема

Пишем что не пишем.

Сейчас скопирую какой-нить текст.

16 декабря, около 9:45 утра, в селе Борино, на автодороге «Хлевное – Липецк» в Липецкой области, произошла авария.

 

Язык PHP, как и множество других языков, поддерживает добавление комментариев в код. Комментарии имеют огромное значение для разработки приложений на php, они могут существенно сократить время изучения кода, написанного сторонними программистами.

Как и куда нужно добавлять комментарии? На этот вопрос только вы и можете дать ответ, я могу лишь указать на несколько обычных мест для комментариев.

  • модули (или классы в ООП), каждый модуль должен иметь небольшую справку для программиста о его назначении;
  • функции (или методы в ООП), старайтесь добавлять комментарии к каждой функции, чтобы следующий программист мог без труда (без исследования кода) разобраться зачем вы написали эту функцию;
  • трудные (на ваш взгляд) участки кода,  если в вашем проекте содержаться какие-нибудь нестандартные решения, то обязательно напишите почему вы сделали так, а не иначе.
  • по окончании работы над проектом напишите последнюю дату редактирования, ваше имя и контактные данные (этот пункт вы можете опустить).
Рейтинг@Mail.ru Яндекс.Метрика