How to write document?

[Daniel Chen]

There are some interface and class implement these interface in my design.Do I need document all these same public methods with the same or familiar words?

[Andrea Gazzarini]

aho Daniel,
Could you explain better?
greetings

[Anonymous]

One way of finding out how docmunentation could be written is to read the API documentation and also check the java sources in src.zip located in JAVA-HOME.
Cheers
Torgny

[Pete Lyons]

I believe Daniel is asking that once he has written the JavaDoc for all the methods in an interface, how should he document the methods of the classes that implement it. I was unsure about this as well. Javadoc will automatically copy the comments from the interface for you if you omit javadoc in the implementation, but I was worried about that, so I added brief implementation comments with @see links to the interface, which had the verbose definition of the method contract.