We have a document for reference/run which looks like it might be better suited as a "how to use run" and the commandline/run.md file which is actually a reference.

Need to take a closer look and see what the intention was in the original design and solve it.