Adding some more documentation

I'm just trying to improve the docs a little bit with the things I had to guess looking at the source code.