Doc changes

- removed build files from git (html, latex, ...)
- changed docstrings to better comply with sphinx (reduce warnings)
- fixed some other small errors

I think it is better if you first test if this branch works for you before you merge it into master.
If it doesnt work I can add some commits afterwards and it can be merged later.

The notebook integration is great! I didn't know that.