undefined | Better HN

0 pointscrdoconnor8y ago0 comments

>And the reason that "the code is self-documenting" is a bad smell is because in 3 months even the 'rock star' who wrote it won't remember without appropriate help

That simply means you're working with poor developers.

0 comments

Clubber8y ago

So you've never written code and come back to it 6 months later said said to yourself, "why did I do this?"

crdoconnorOP8y ago

Many years ago yes, but not recently.

If you're a supposed "rock star" senior developer doing this it means you're just a bad developer. If you're a junior doing it just means you have some maturing to do.

tbrownaw8y ago

There are two kinds of that.

One is "wtf was I thinking", which comments won't help with.

The other is "where did the requirement come from", and that's (1) not a "cock-sure of themselves" sort of thing; and (2) best solved by putting a tracking number on the commit message, rather than traditional code comments.

j / k navigate · click thread line to collapse