model class updates and method documentation