consistency updates to watcher documentation