Some docs improvment

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