issue #235 - small edits to flows API doc