Hacker News
new
|
past
|
comments
|
ask
|
show
|
jobs
|
submit
login
dahvyd
on Aug 15, 2012
|
parent
|
context
|
favorite
| on:
Thoughts on being a programmer
Consider the standard Java
cough
paradigm used by multitudes of developers, and on by default in many Java IDEs:
/* Gets the person's name @returns the person's name */ public String getName() { return name; }
That is insane. The comment adds nothing to anyone's day and helps no one better understand the method than after simply reading the method signature.
flatline3
on Aug 16, 2012
[–]
It generates auto-docs, which
are
useful. It's just a ridiculously verbose way to do it, and it would be preferable if the documentation could be generated without the repetitive comment.
Guidelines
|
FAQ
|
Lists
|
API
|
Security
|
Legal
|
Apply to YC
|
Contact
Search: