Add documentation

[eloff]

Generate documentation, link to it at the top of the readme, and make sure all public methods/types are documented.

Mark things that are public but "internal" as such.