more documentation for the model class