factory: update docstring of run()
README.md: update description