Fix/docs

[wpfff]

the doc structure took a few odd turns and was quite neglected. we're starting this fresh.

[jenshnielsen]

@wpfff What do you think about letting github actions build the docs in ci so this does not happen again?

[wpfff]

hm, so currently I'm only aware of a web hook to build docs on RTD automatically, that's not an issue.
The thing here is more that the docs weren't very good :)
I currently have one of my students (@marcosfrenkel) work on this.

because we have some other tools that build on qcodes we were now thinking of setting up the following:
docs within the package are 'only' good docstrings, essentially.
The 'manual' we would like to do such that it captures multiple packages that we maintain and will live under a separate repo (https://github.com/toolsforexperiments/tfe-manual) that links to toolsforexperiments.rtfd.org.

Do you have any thoughts?