doc cleanup in prep for real API

Signed-off-by: AJ Rossini <blindglobe@gmail.com>
docs and API cleanup

Signed-off-by: AJ Rossini <blindglobe@gmail.com>