Add inline docs

[jwoertink]

Now that we publish API docs, we need to start filling in all of the actual inline documentation. Once that's done, the docs in the README can point to the official API docs.