[DRAFT, WIP] PSR-5: PHPDoc Standard

This PR represents the current state of affairs with the PHPDoc Standard. Until this description and subject is altered this PR is considered a Work in Progress and not ready for a final review.

All feedback is welcome, please direct this to the PHP-FIG mailing list to prevent noise in this PR. This PSR covers so many subjects that unless the discussions are separated by topic that it will probably be quite impossible to follow in this PR.

I would also request that people open a thread per issue they would like to discuss and not combine several issues in a single mail; this will help to keep noise-levels down in discussions and for me to loook back or filter important information.

TODO items are tracked in the issue tracker for this PSR: https://github.com/phpDocumentor/fig-standards/issues
The standard already allows for both, so things aren't being left in the middle any more than they currently are. Defining one absolutely over the other won't work since people will just ignore that part of the spec anyway (WordPress which powers around 20% of all websites is in the omit school).
The question isn't A vs B, but about recommending A over B when there's really no need to. The split between the opinions is probably somewhere close to 50:50 in the real world (and the representatives in the PHP-FIG may not represent that split). For every person who thinks omitting is bad, there's another who thinks including is bad.  "No recommendation" is the only fair way to encompass the historical preferences of each opinion, while still allowing both within the spec.