added some javadoc to the model.