To be fair, documentation is very often a much longer route to understanding your specific use case. At the same time, SO is responsible for far too much cargo cult programming and I fear ChatGPT will be the same for this.
And there are way too many projects where the documentation is nonexistent or bare to the point of being counterproductive to wade through. I’ve seen way too many open source projects that purport to have documentation but when you open it, it’s just doxygen run over the raw source files with barely any documenting comments in them. If I wanted to see only the names of the classes and functions I’d just pop the source in an IDE, the point of documentation is to point out everything that isn’t immediately obvious just looking at names and to give examples.
“Self-documenting code” is the biggest lie we tell ourselves to get out of writing actual, necessary documentation.
You are not logged in. However you can subscribe from another Fediverse account, for example Lemmy or Mastodon. To do this, paste the following into the search field of your instance: !programmerhumor@lemmy.ml
Post funny things about programming here! (Or just rant about your favourite programming language.)
Rules:
Posts must be relevant to programming, programmers, or computer science.
No NSFW content.
Jokes must be in good taste. No hate speech, bigotry, etc.
To be fair, documentation is very often a much longer route to understanding your specific use case. At the same time, SO is responsible for far too much cargo cult programming and I fear ChatGPT will be the same for this.
And there are way too many projects where the documentation is nonexistent or bare to the point of being counterproductive to wade through. I’ve seen way too many open source projects that purport to have documentation but when you open it, it’s just doxygen run over the raw source files with barely any documenting comments in them. If I wanted to see only the names of the classes and functions I’d just pop the source in an IDE, the point of documentation is to point out everything that isn’t immediately obvious just looking at names and to give examples.
“Self-documenting code” is the biggest lie we tell ourselves to get out of writing actual, necessary documentation.