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

    +148

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

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

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

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

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

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

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

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