Docs

Addressed some dartdoc nits found by the dartdoc tool, and added a `docs` task to the build.

@keertip @gaurave