doc and monitoring cleanup

shouldn't we use those silly restructuredtext link things or do these get linkified automatically?