First page Back Continue Last page Text

Notes:


The purpose of reviewing the class design is to agree the role and interface of each class within a package. (There are generally more classes than appeared at the package review because of utility classes – like exceptions or carriers of data).

Documentation is produced using javadoc – the class designer creates the public part of the class files with the method bodies dummied out (throwing a "not implemented" runtime exception).

This was hard to get across – developers were either reluctant to offer classes for review until they had written implementations for methods, or wanted to leave parts of the method specification until they had implemented them (especially the @throws tag). We got there – and they can't now see why it was so hard.