Improve documentation

fixes #25