document updates by Alissa

Signed-off-by: Alissa Fitzgerald <amf@amfitzgerald.com>