в опенсорсе можно в комментариях даже примеры описать и подробности разные
@var
? Код пишется понятным языком. В принципе, по названию методов, классов, папок и передаваемых параметров понятно что он делает. В коде отсутствуют такие общие названия как
Если код надо документировать (писать комментарии о том, что он делает), это плохой код.
$items
, $model
. Вместо этого $posts
И $post
. А все потребители вашей библиотеки перешли на PHP 7.4?Библиотеку старой версии никто не отменял. Но уже сейчас хочу выпустить новую версию с минимальными требованиями php7.4.
В большинстве случаев все достаточно прозрачно, но документацию по проекту и классам никто не отменял.
@var
, @return
? В будущем, возможно, будет и описание, но пока что нет. А по phpDoc — явно нотации кроме @throws, @return/@var Class[], @method остальные лишниеПравильно ли я вас понял, что и к open source проекту это тоже относится.
@var
и @return
лишнее? Сейчас у меня везде сгенерированные phpDoc. Теперь думаю удалять их или оставить. С одной стороны в них особой пользы нет. Комментариев и пояснений не дают, а просто дублируют свойства, которые и так понятны. Да и код при этом становится длиннее. Как лучше? Счётчики для конкретных записей - делаются рядом (в той же таблице, доп.колонкой).Если полей счетчиков много? Имеет смысл вынести в отдельную таблицу? Или в большинстве случаев достаточно этого? Сколько по вашему опыту можно хранить счетчиков рядом, а при каком количестве отдельная таблица? Если говорим о MYSQL или другой реляционной БД.
Собирается - всё через update-запросы в виде транзакций из других таблиц.У меня события реализованы не в базе, а в коде. С помощью EventDispatcher, где есть Event и Listener. Мне кажется так правильней, чем события БД. При смене БД или переносе данных в таком случае могут возникнуть сложности. И с тестами проблема. Что думаете?