more documentation improvements

as usual, here is the generated doc https://rawgit.com/APItools/monitor/documentation/doc/index.html