Size: a a a

2021 June 10

ДК

Дмитрий Кожанов... in Yii Framework 2
Я придираюсь только потому что он выкатил это в общественность. И как я считаю:
1. Код должен быть максимально описан, что делает функция, что ты получишь и что она может выкинуть
2. У кода должны быть тесты
3. Код должен соответствовать стандартам, принятым PHP сообществом
источник

GV

Gena Voituk in Yii Framework 2
никто тебя не просит это всё расписывать. Достаточно описания передаваемых параметров, что возвращает функция и какие бъёт ошибки. Для этого можешь в шторме после написания функции напечатать /** и нажать enter  - у тебя шторм сам всё заполнит
источник

Д

Дмитрий in Yii Framework 2
ну вот разве-что это..
а так я просто кучу кода перелопатил, и везде комменты врали. в 90% случаев.. даже те же @throws бывает были там, а по факту там уже ничего не thorw-илось
источник

ДК

Дмитрий Кожанов... in Yii Framework 2
Кидаешь issue что комменты кривые
источник

Д

Дмитрий in Yii Framework 2
спасибо, я в курсе.
источник

GV

Gena Voituk in Yii Framework 2
абсолютно согласен
источник

GV

Gena Voituk in Yii Framework 2
тогда почему, с твоих слов, ты это не используешь?
источник

Д

Дмитрий in Yii Framework 2
перечитай мои сообщения. я не то что не использую - я это выкидываю отовсюду, где это возможно.
источник

Д

Дмитрий in Yii Framework 2
это гнилой код по большей части.
источник

GV

Gena Voituk in Yii Framework 2
ещё раз - зачем? Такой код намного читабельнее
источник

ДК

Дмитрий Кожанов... in Yii Framework 2
щас бы симфу гнилой называть )
источник

Д

Дмитрий in Yii Framework 2
такой код часто врёт.
источник

Д

Дмитрий in Yii Framework 2
кто-то что-то написал, потом кто-то переделал. коммент остался
источник

ДК

Дмитрий Кожанов... in Yii Framework 2
Ах да, забыл что код должен стараться быть максимально универсальным. Если PHP  поддерживает Windows, должно быть сделано все чтобы функции работали одинаково везде. (на это и нужны тесты)
источник

Д

Дмитрий in Yii Framework 2
если код "читабельнее" становится благодаря комметариям - это плохой код.
источник

V

Victooor in Yii Framework 2
+ (с) Макконел "Совершенный код"
источник

ДК

Дмитрий Кожанов... in Yii Framework 2
простой пример
Комменты указывают на проблемы свзанные с особенностями работы. И для какой цели добавлен этот код
источник

Д

Дмитрий in Yii Framework 2
ну тут - да.
но то что генерит, например, шторм, повторая то что в заголовке ф-и и так написано - нафиг не нужно.
источник

S

Sergey in Yii Framework 2
Надо когда у тебя большой проект, ты пишешь функцию и шторм тебе сразу подсказывает аргументы этой функции и т.д.
источник

ДК

Дмитрий Кожанов... in Yii Framework 2
Опять же. Универсальность. Штормом пользуются не все.

Это знаешь, как выпустить машину в тираж. Без документации к ней. А херли, все же на машинах ездят - знают как починить.
источник