Is there any desire to bring something like PSR-5 back?
There are two reasons why I think there should be some standards related to the doc block.
A) For legal reasons, every file needs to have author(s) and license specified in a way that it can be programmatically retrieved.
File level comment with @author and @license seems to be the defacto way that is done.
B) Code analysis tools often use function comment blocks to determine what type a parameter should be and what type the output should be. Psalm is a good tool for doing that, and since I started using Psalm it has found many bugs of mine that I otherwise would never have triggered myself but I could see how someone using my classes might.
But there is some confusion there. I usually specify the types as they would be used in type hinting (e.g. bool or int) but some standards want those same types expressed as boolean or integer. vimeo/psalm seems to like the way I do it, may work with the other I don't know, but that's where a standard like PSR-5 would be useful. It could specify how to indicate the type and then both code analysis tools and programmers can follow the spec.
For the most part I think the old PEAR standard is good and most of my checking is done against that, but I just wanted to express that at least one user would be very interested in something like PSR-5 existing.
Thank you for your time.