added docs on validation and polymorphism