• 2 Posts
  • 18 Comments
Joined 2 years ago
cake
Cake day: July 29th, 2024

help-circle




  • Ok, I’ll take the bait.

    This is not longer about whether they’re capable of not, they’re just a mere tool, it’s about supporting an unsustainable industry that’s destroying the environment, economy, society and already working technologies for… well, nothing, it’s not even profitable yet, they’re slowly getting into the find out stage.

    Not to say that, even if they are capable of “keeping documentation up to date”, they’re unable to do software engineering, most software projects fail because bad design decisions. And btw, documentation is not limited to code comments, API endpoints or whatever a JavaDoc is in your target programming language (methods and attributes comments, if OO, on how they work / what they do / how to use them).

    Professional grade documentation goes beyond that, begins with the problem you’re trying to solve and goes all the way to the end of life of your system. Yes, it’s hard to maintain it up to date and will slowly become outdated, but it’s bound to happen, it’s almost as if you wanted to have 100% of testing coverage, it’s economically impossible.