• Post Reply
  • Bookmark Topic Watch Topic
  • New Topic

Recoment the implemented methods?

 
Gabriel Ozeas
Ranch Hand
Posts: 30
Google App Engine Hibernate jQuery
  • Mark post as helpful
  • send pies
  • Quote
  • Report post to moderator
Hello guys,

I always have the curious to know if it's necessary recoment the methods that are been implemented. They are already comented in the interface, and as i read the doc comments can't have details of implementation. And if they have the same funcionality describing in the interface, why i need to recomment? What about OCJD? Like DB.java and Data.java for example.

Bye, bye
 
Roel De Nijs
Sheriff
Posts: 10662
144
AngularJS Chrome Eclipse IDE Hibernate Java jQuery MySQL Database Spring Tomcat Server
  • Likes 1
  • Mark post as helpful
  • send pies
  • Quote
  • Report post to moderator
I use a lot of {@inheritDoc} in my comments, like this:
 
Gabriel Ozeas
Ranch Hand
Posts: 30
Google App Engine Hibernate jQuery
  • Mark post as helpful
  • send pies
  • Quote
  • Report post to moderator
Thanks so much Roel. I didn't know about this tag. HEHE

Bye bye
 
Jonathan Elkharrat
Ranch Hand
Posts: 170
Ubuntu
  • Mark post as helpful
  • send pies
  • Quote
  • Report post to moderator
i think by default the generated html includes a line like that:

Specified by:
MethodName in interface InterfaceName

so you could write a very simplistic description ("add a record to the database")
and if someone want to know more he just have to click the interfaceName...
 
  • Post Reply
  • Bookmark Topic Watch Topic
  • New Topic