doc and monitoring cleanup

that's really long