Some docs improvment

I am writing some modules, so when I found somethings missing or wrong into the documentation I update it.

Fix CodeSniffer errors and some warnings

Perhaps add a category for devel documentation