a bit of documentation for the either-step in todo-pipeline