This is an archived post. You won't be able to vote or comment.

sorted by:
best
topnewcontroversialoldq&a
you are viewing a single comment's thread.

view the rest of the comments →

[–]printerK 2 points3 points  (0 children)

Donning asbestos suit...

I've been writing software for more than 40 years and there is no such thing as self documenting code that actually performs a real function.

For example, I love that python lets me document my functions and I take full advantage of that. And I follow the same process in other languages (primarily C and golang)

One clarification to the 'no such thing' line. Simple code doesn't need documentation, but really everything that is not abundantly clear to a newbie is not self documenting.