tighten documentation and explain how to run beyond the quickstart