Feature/review docs

I've reviewed the documention everywhere except in the `SisyphusMasterActor` (which I will leave to @Smeds) and in the API (which I will leave to @b97pla). Sorry for the messy commits.