Это проблема не документации как таковой, не Java и даже не следования каким-либо ГОСТ'ам или же их сознательного игнорирования. Это следствие того, что подобные "комментарии" пишутся чисто для отмазки, просто 'чтоб было'. И качество и содержательность подобной "документации" никто не контролирует. Что говорит о том, что подобная документация никому не нужна.
То есть проблема лежит не в плоскости используемых средств или же внешнего вида/оформления, а в плоскости организации проекта.
