QA: PHPDocs improvements

[michalbundyra]

Q	A
QA	yes

Description

Improve PHPDocs in the library.

[michalbundyra]

After reviewing it, I've decided to close it, as I am noto honestly sure if it's gonna work as expected. Reflection can read parent docblock, but in my opinion resolving param types is not working properly. Unless there is some assumption somewhere that we should use always FQCN in docblock to get it working properly.

For now, if we have:

namespace Laminas\Server\Something;

class Node
{
    /**
     * @param self $node
     * @param Node $parent
     */
    public function abc(self $node, self $parent) { /*...*/ }
}

we get types:

• self for $node, and
• Node for $parent,

but I believe we should get \Laminas\Server\Something\Node for both of them.