more validation of model objects, documentation changes