Jesper de Jong wrote:So I'd choose option b.
Avor Nadal wrote:This strategy has some caveats though. The most important is that it adds more and more lines of code, forcing me to extract methods even for very simple constructions, where people usually had wrote 1-2 lines at most.
I've checked some projects at GitHub, from people who tell that they write self-documenting code
Avor Nadal wrote:Another possibility to give names to arguments is to use short comments, but it makes the code look like "ugly" and make it harder to read: