Better document all public API endpoints and the system config

[erikfrey]

• Add examples to docstrings
• Make sure args / returns are fully fleshed out
• Add documentation to config format, in particular to joint config which can be confusing to new users