updating doc (following apigen doc tags) + PSR-1 PSR-2 fix
[skip ci]