Code conventions

Have a look at these:

How to write comments for classes

@ingroup all files in a plugin are in a group (naming convention: ...)

@see use this to link to the parent function if you changed the parameters or description of the function

@copydoc use this to copy the documentation of the parent function

see for more details

Dos and don'ts

If possible try not to use the static Request:: but $this->getRequest().