added model javadocs