Documentation

[DaveOri]

readthedocs is broken. Probably some errors in the compilation prevents from filling the pages with autodocs.

I also received some requests from users to improve the documentation. General points would be:

• description of input and outputs, with units
• more clear examples (not sure how to get this, maybe some different use-cases)
• description of the domain (x,y,z,time). Difference between _lev and layer coordinates, something like that...

I will try to start a github project on this. There are going to be several sub-issues and assignments to address. Any contribution will be helpful, even just writing tasks in the to-do list would be great

[spirrobe]

I had a look at using pamtra myself and ran the make htmldoc which shows that the error is basically an unescaped | in the settings.rst
As an intermediate solution I put the doc on our ETHZ server: https://iacweb.ethz.ch/staff/rspirig/pamtra/
I'll open a PR with the fix (| -> |)
This does of course not cover the rest of your listed improvements.

[maahn]

I fixed readthedocs: 9de11da