tag:blogger.com,1999:blog-4133036378510199203.post7317970168834122586..comments2023-11-03T08:59:47.410-07:00Comments on Dot Neverland: Documentation that is usefuljulian_zahttp://www.blogger.com/profile/08278483453087084978noreply@blogger.comBlogger2125tag:blogger.com,1999:blog-4133036378510199203.post-44907766933154980802013-01-06T08:07:46.179-08:002013-01-06T08:07:46.179-08:00nothing that makes me want to pack up my toys and ...nothing that makes me want to pack up my toys and go home more than<br /><br />- auto-generated documentation<br />- obvious documentation<br />- @author tags that include the date, time and second the file was generated. By the time I read your @author tag, it's likely that this is the only line in the class that you committed.<br /><br />If you feel compelled to write a novel after typing a line of code, do it in the commit message.Groffthttps://www.blogger.com/profile/14691887819538126512noreply@blogger.comtag:blogger.com,1999:blog-4133036378510199203.post-45552279725768349042012-02-05T23:10:20.564-08:002012-02-05T23:10:20.564-08:00As per my experience, not all document is useful s...As per my experience, not all document is useful special if too big to be maintained<br /><br /><a href="http://extreme-java.com" rel="nofollow">Java Tutorial</a>Sandeephttps://www.blogger.com/profile/14459583259453333684noreply@blogger.com