updated flow, added new configuration options and updated documentation