4. точными

5. своевременными

7. http://www.phpdoc.org/

9. Могут быть сконвертированы в HTML, PDF или CHM файлы

10. $ phpdoc -h

14. каждый класс

15. каждое свойство или константа класса

16. каждый метод класса

17. каждая функция

19. /**

20. * @param string $name Имя пользователя

21. */

23. /**

24. * @author Aliaksei Shytkin < [email_address] >

25. * @author Mahatma Harash <krishna@gmail.ind>

26. */

28. Версия с автоматическим подставлением информации о последней ревизии файла

30. @subpackage <имя подпакета>

31. Для указания структуры проекта

32. /**

33. * @package Form

34. */

36. Для свойств классов

37. Тип переменной используется IDE для автокомплита

38. /**

39. * @var sfGuardUser Владелец экземпляра класса

40. */

41. $owner = null;

43. Для функций и методов

44. Тип переменной используется IDE для автокомплита

45. /**

46. * @param sfGuardUser $user Пользователь оплачивающий ордер

47. * @param mixed $order Данные ордера

48. */

49. public function process($user, $order){}

51. Для фукций и методов

52. /**

53. * @return sfGuardUser

54. */

55. public function getOwner()

56. {

57. return $this->owner;

58. }

60. /**

61. * @todo Перенести в шаблоны

62. */

63. public function translateTitle()

64. {

65. return __($this->title);

66. }

71. для каждой инструкции внутри файла ProjectConfiguration.class.php

72. для каждой связи события $this->dispatcher->connect в файле конфигурации приложения

74. к каждому полю модели в yaml файле модели и другим инструкциям внутри файла модели