DEV Community

Discussion on: Bullsh*t Of Self-Documenting Code

Collapse
 
intermundos profile image
intermundos

100 % true.

If you seek a new job and hear we have a culture of self documenting code, say thanks you, stand up and leave the room.

Self documenting means no one cares a penny about the codebase and it is in a terrible condition.

Of course, perhaps, there is few companies that do have it done right

Collapse
 
m0n0x41d profile image
Ivan Zakutnii

Hey, you are right. Unfortunately, in 3 out of 5 cases, they use 'self-documenting code' as an excuse for laziness and carelessness about formal specifications and architecture.