Added documentation to methods

I added some more documentation to the API. Please give me a hint if I got something wrong.

The line where I added the `()` was due to a warning of ruby. It was not intended to add the line to this PR, but I oversaw it during `git add -p`. Hope it's ok to leave it as part of this PR.