Better documentation

Since we now publish a Javadoc JAR (see #36 ), it would be nice to fix the errors and warnings produced by the `dokka` plugin that we use. In other words, it would be nice to provide the missing documentation.