Documenting Your Code
This is a detailed spec on how developers should be documenting their code. While inline code comments are very important, this specification will be focusing on docblock structure.
Docblocks are required for all class methods & properties/attributes. The reason we have this spec, and the reason that actual language standards exist for docblocks, is so that generators will know how to parse your code & render consumable html documentation.
For this reason, documentation standards follow the existing spec's that are currently community standards at the time of writing, and we should be following them.