[TASK] adapt controller flow and docu