Автор оригинала: AmdY
это субъективно. мне тоже не нравятся такие комменты, кроме мест где это действительно критично, например, класс возвращаемого объекта.
Если результат - результат работы метода, а метод документирован и возвращает объект конкретного класса, а не абстрактного или интерфейса, то IDE в помощь
Автор оригинала: AmdY
а с кучей комментов мне читать сложно, даже с учётом фолдинга.
соглашусь
мне гораздо проще средствами той же IDE перейти к описанию переменной, чтобы понять её тип, но не всегда соблюдается условие, что внутри функции/метода/глобальной области видимости не переописали это переменную
с выдачей префиксов по типам переменных есть несколько сложностей для сторонников единообразности:
1. появляются исключения для i, j, k ...
2. php до сих пор не предполагает строгой типизации, как следствие, возможность плотно эксплуатируют. Как префиксовать аргументы/переменные в этом случае, [$stuff]Entity?
список можно продолжить