Improve the documentation.

Sorry for the commit message… did it with GitHub.