Revert "Remove incorrect comment"

This reverts commit 67afd2dc5eef76b6168c30c46f6d7b361301a19e.
Document watcher specific flapping options

Ref. #615
Merge pull request #621 from amarandon/watcher-specific-flapping-options

[Documentation] Watcher specific flapping options