News for hackers. Stuff that matters.
Re:The absolute worst scenario happened by foobiekr on Monday March 22, 2021 @03:03PM (#26545256)
This. I actually think just documentation is, well not completely worthless but close to. Imagine telling someone they could learn to weld airframes by reading. Just no.
Re:The absolute worst scenario happened by twobitshifter on Monday March 22, 2021 @04:23PM (#26546394)
For software, it’s the maintenance task that’s helped by documentation not building. They still need to know how to build but it’s a lot easier with documentation. I know that when we use software packages we all rely on the documentation to understand how to use it and code our desired behaviors. It’s obvious that our own code can benefit from documentation in the same way.
Re:The absolute worst scenario happened by rantwasp on Monday March 22, 2021 @05:17PM (#26547236)
documentation is required but not sufficient. also, documentation is usually outdated really fast if the person maintaining the system leaves and/or does not care