All the classes (at least interfaces and those used directly by clients) should have Javadocs at class level and at least for all public methods.