Document, confusing
Add FIXME
Improve some package-level javadocs. Formatting and content issues.
Add package docs for more packages (not quite all though).