doc cleanup in prep for real API

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