Skip to content
CONTACT

Eagleson's Law

PROGRAMMING AND BUGS

Any code of your own that you haven't looked at for six or more months might as well have been written by someone else.

— Anonymous, Saying common among programmers; origin and identity of Eagleson unverified (uncertain attribution)
VIDEO.EXE16:9

You open an old file. Who wrote this thing? Variables called 'foo2', no comments, a three-hundred-line function. You check the author. It's you. Yourself from six months ago, a total stranger with your login.

The law teaches that the first reader of the documentation isn't your colleague: it's you in the future, who will have forgotten everything. Writing clear code is an act of kindness towards a stranger who looks a lot like you.

These days I treat my past self as an outside consultant. I send him complaint emails. He never replies. Yesterday I found one of his comments: 'Fix later.' Later when? We're in later now. Later is me.