added docs, see #170
removed unused docs, see #170
removed duplicated code in FlowModel.step, see #170