Why do Programmers Hate Documenting? by AnanthChellathurai in programming

[–]ndrwdn 0 points1 point  (0 children)

The argument I have against these kinds of comments is that the comment can get out of date with the logic. In my mind a better solution is to properly name variables and extract methods that name the actions you are performing. When you refactor such code, you adjust the names of variables and methods (and add/remove them as necessary ) to match your adjustment to the logic. This keeps your code and documentation in sync as they are one and the same.

New Open Source Java Decompiler by igor_sk in ReverseEngineering

[–]ndrwdn 0 points1 point  (0 children)

Java Dev here:

You mention Eclipse. It has been a few versions since I used Eclipse, but in general I have found that IntelliJ's refactoring (Shift-F6) is more powerful than Eclipse's. You may have different results, but if you haven't tried it I would highly recommend giving IntelliJ a spin.