API docs

[nateabele]

Each part of the public API of this module should be documented. (Still need to investigate standards for documenting JS code).