improve setup docs

[mambocab]

The docs could generally be clearer. This issue and its comments can be a dumping ground for problems with the docs.

• It's not clear from the docs that the frontend and tool parts of cstar_perf run on different machines.