Should I be writing Doc Comments for all of my java methods?
I do believe the current choose answer is incomplete and partially false. I have synthesized the best of the other answers in a community-wiki post (no karma involved). You might consider choosing this one instead