I try to always treat the JavaDoc with the thought, that the XML Schema doc may not exist - since **just theoretically** somebody could use the classes programmatically.