added response and possible errors
Refactored parameters so that the object being validated is passed to validate.rb
Documentation fixed to work with recent refactor
added type description