PHP DocBlock are mainly built up by three different parts, which all together create one DocBlock:
- The Summary
- The Description
- The Tags
The summary is a one-liner, which descripes what the code block is all about.
The description adds more details about the described code in form of an extended text.
Tags describe the properties, for example
More details on the topic can be found in the phpDocumentor docs.