doc and monitoring cleanup

"Updating long term" this sounds awkward and isn't super clear