schemas documentation
javadoc minor fixes