Better explanation of annotated source generation.
Remove Documentation section.

I think it would be better to have a sectio with links, probably earlier
in the README or throughout it. For example, there already is a link to
the documentation.