The biggest lie devs tell themselves: this will be a living document.

  • 1
    Slightly bigger lie is the documentation has anything meaningful
  • 1
    Is the source code with its comment a good documentation?

    Just run a docu gen script over it as part of change commit and the docu is created.
  • 0
    Reality: this will soon be a decrepit, bug-riddled and festering codebase in the dark corner
  • 0
    Only maybe maybe maybe if you’re using python notebooks rondoniense things, but still your data sources can go stale some day and your doc dies with it
Add Comment