added better docs to flow xml