История изменений
Исправление Aber, (текущая версия) :
вас не смущает, что вы документацию в рантайм, по сути, суёте? при том явно это декларируя, мол вот этот _лишний_ объект (и вызов метода), потому, что _мне_ лень доку прочитать (или сорцы глянуть).
Доку часто пишут только над интерфейсами, причем ключевыми. Дока может отставать от изменений в коде, человеческий фактор, автоматическим тестированием несоответствие доки и фактического кода выявить нельзя.
(или сорцы глянуть).
Утопия. Чтение и анализ кода меленее чтения декорации. И мы говорим про java а не про числодоробилку на си, тут оптимизации ухудшающие читаемость не приняты.
Исходная версия Aber, :
вас не смущает, что вы документацию в рантайм, по сути, суёте? при том явно это декларируя, мол вот этот _лишний_ объект (и вызов метода), потому, что _мне_ лень доку прочитать (или сорцы глянуть).
Доку часто пишут только над интерфейсами, причем ключевыми. Дока может отставать от изменений в коде, человеческий фактор, автоматическим тестированием несоответствие доки и фактического кода выявить нельзя. Код
(или сорцы глянуть).
Утопия. Чтение и анализ кода меленее чтения декорации. И мы говорим про java а не про числодоробилку на си, тут оптимизации ухудшающие читаемость не приняты.