more javadoc for models