flow-monitor: Update documentation format

This MR updates Flow Monitor documentation according to #1139.

Small additions of content are also made (including a figure)

Release notes and changes will be updated before the final merge.