Docblock augments

[DerManoMann]

Fixes #1224

Extends the AugmentParameters processor to also look at the operations docblock.

Example:

class Controller {
    /**
     *
     * @param string $foo The foo parameter.
     */
    #[OAT\Get(path: '/lookup/{foo}')]
    #[OAT\PathParameter(name: 'foo')]
    public function lookup(string $foo) {
       //
    }
}

Here the foo path parameter would be augmented with the description from the lookup() function docblock - The foo parameter.

This behaviour can be turned off via Generator::setConfig():

(new Generator())
    ->setConfig(['augmentParameters' => ['augmentOperationParameters' => false]])