Add documentation

I've added documentation to the python function, and specified the name of the arguments so that the functions can be called with kwargs.
Also I've added a docs folder which contains a configuration file for sphinx. The outputted documentation is not perfect, but it's better than nothing.

Any comments?
@mortenvp 
@petya2164