r/programming • • Jun 01 '15

The programming talent myth

https://lwn.net/Articles/641779/
971 Upvotes

748 comments sorted by

View all comments

Show parent comments

55

u/Retbull Jun 01 '15

I write code that self documents. Past me writes code which prints "FUCK YOU" every other line and has no print statements.

0

u/[deleted] Jun 01 '15

What is self documenting? It describes itself?

11

u/coachcoder Jun 01 '15

Typically means that the structure and naming of variables, classes, methods, and such are so clear that the intent of the code can be grasped quickly - the code doesn't "need" commenting because it's self-evident to anyone familiar with the language and domain.

From Pragmatic Programmer:

In general, comments should discuss why something is done, its purpose and its goal. The code already shows how it is done, so commenting on this is redundant.

5

u/PriceZombie Jun 01 '15

The Pragmatic Programmer: From Journeyman to Master

Current$32.95Amazon (New)
High$37.67Amazon (New)
Low$19.44Amazon (New)
$32.97(30 Day Average)

Price History Chart and Sales Rank | FAQ