> What you describe about the development process, ... , is important but doesn't really belong in the source code. Except that in really big/successful projec

> What you describe about the development process, ... , is important but doesn't really belong in the source code. Except that in really big/successful projects, the proper places are outdated specs that end up buried in obscure unindexed archives. This can happen for a lot of reasons, technical debt, intellectual property acquisition, erosion of institutional knowledge due to personnel attrition, etc. On the other hand, source code is forever. It is the thing that you cannot unknowingly get rid off without getting rid of (your ability to update) the product itself. > Da Vinci didn't write on the back side of the Mona Lisa the production process for his paints. If you were a curator of the Louvre Museum, your job would have been easier if he did.