1. PHP / Говнокод #9428

    +148

    1. 1
    2. 2
    3. 3
    4. 4
    /**
	 * Assign
	 **/
    function Assign ($mTplArray, $mTrailer = "")

    Зачем этот комментарий, над каждым методов вообще?!
    Будто я не вижу как называется метод класса.

    Запостил: Zerstoren, 15 Февраля 2012

    Комментарии (4) RSS

    • ava volhv 15.02.2012 13:00 # −1

      Для PHPDocs
      Ваш Кэп
      Ответить

      • ava Zerstoren 15.02.2012 13:07 # 0

        Сначала почитайте что такое PHPDoc и как он пишется.
        Для PHPDoc не менее важно, описание параметров и возвращаемый результат.

        И писать имя метода для него не надо

        /**
        * Короткий комментарий
        *
        * Длинный комментарий
        *
        * Описание всех параметров
        * Описание возвращаемого результата
        */
        Ответить

        • ava Steve_Brown 15.02.2012 14:19 # +1

          /**
          * Присвоить
          *
          * Эта функция выполняет присвоение
          *
          * Параметры:
          * mTplArray - массив
          * mTrailer - трейлер (необязательный параметр, по умолчанию пустая строка)
          * Возвращаемые значения:
          * нет
          */
          Ответить

    • ava gegMOPO4 15.02.2012 14:01 # +2

      Автоген?
      Ответить

    Добавить комментарий