Documenting Your Brilliance
/via http://geekandpoke.typepad.com/geekandpoke/2010/03/simply-explained-entropy.html |
The two different times when your code made sense to you
1) When you wrote it
2) (Later) When you spent hours pouring over it, and figured out — again — what it does.
1) When you wrote it
2) (Later) When you spent hours pouring over it, and figured out — again — what it does.
The amazing thing is, it tends to be blindingly obvious each time you figure it out.
The even more amazing thing is how you didn’t add any documentation, even after -2-, because this time you were sure you had it figured out.
Comments