The Surprising Power of Documentation

Re:The Surprising Power of Documentation by CharlieDigital on Monday June 12, 2023 @07:38AM (#36291879)

> Imagine working on a codebase where 80% of the code was unused or commented out

That's not documentation; that's code.

[ Parent | on HN ]

Re:The Surprising Power of Documentation by phkahler on Monday June 12, 2023 @07:45AM (#36291941)

>> That's not documentation; that's code.

It's an analogy to make the point - we delete old code that's not relevant any more. Imagine reading documentation where 80 percent of it is no longer relevant but is kept around "just in case".

[ Parent | on HN ]

Re:The Surprising Power of Documentation by franciscop on Monday June 12, 2023 @07:55AM (#36292042)

Thanks for explaining, I thought by saying "Imagine ..." it was clear that it was meant to be an analogy

[ Parent | on HN ]