added documentation to flow.rst