Hi guys,
When I mean to document this I refer on the first line on the
java doc documentation(comments). There are plenty of example in this way in the java API doc.
On the other side the documentation is quoted with 70 points, will be a peaty lose some point here.
Rinke, you make a serious assumption here ("Personally, I do not think that Sun is looking at our assignments at this level. I would be surprised if these kind of details will cost you points"), if a documentation lets paces for doubts then you'll lose some points.By example if someone will try to build a test for your class and for this he(she or it) needs to read your source code for this you risk to lose more points. In opposite if you "program with contract" the test builder need only to read the contract and to build the test.
Regards,
M
[ May 08, 2007: Message edited by: Mihai Radulescu ]
SCJP, SCJD, SCWCD, OCPJBCD