Email or username:

Password:

Forgot your password?
Ian Douglas Scott

All engineering is reverse engineering if you document things poorly enough.

12 comments
:new_l:​ src :new_r:​

@ids1024 me compiling my code into assembly so i figure out what my arbitrarily named function does

DELETED

@ids1024 I thought that was job security.

kabdib

@ids1024 "Any sufficiently advanced technology is insufficiently documented."

J. "Henry" Waugh

@ids1024 please stop holding a mirror to my work life

The Doctor

@ids1024 Do you mind if I quote you on that?

Gordon Oliver

@ids1024 you could have left the tautology off the end.

spaceape

@ids1024

Standard documentation be like

.header {
background-color: green; // makes header-background "green"
}

😇

leap123

@ids1024 All engineering is reverse engineering if you document things too much

Paul L

@ids1024 My colleague Stefan had the habit of just writing readable code; I kept writing documentation…
Turns out that readable code was much more liked by others…
Readable method names and easily refactorable code are much impactful than documentation!

DELETED

@polx @ids1024
Actually, the Tests are the documentation.
If they're written well enough and placed in a Clean Code environment :-)

Nothing checks your textual docs. It is utterly frustrating to find out that the documentation is just wrong.

Go Up