doc and monitoring cleanup

from a docs point of view, or something else?