organizing and commenting

Signed-off-by: Ted Young <tyoung@pivotallabs.com>