update readme to endorse tokens
remove photo method in students
add YARDoc comments to clever-ruby
fix documentation errors