documentation additions and comments

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