Doc review 9 26 14

again... not sure if I'd use `required`