doc and monitoring cleanup

this is actually a really helpful section for newbies I think