Feature/more docu

We have documented all the public methods, now we can close #17.