News for hackers. Stuff that matters.
Re:We are drowning in information while starving for wisdom ... by imiric on Wednesday December 21, 2022 @01:31PM (#34084468)
> Documentation now is no where near the quality of older stuff.

I wouldn't make a blanket statement either way, but there are certainly counterexamples to this:

- The mpv manual[1] is a work of art.

- The Arch Linux wiki[2] is a treasure trove of information for not just Arch-specific topics, but Linux in general.

- MDN[3] is the defacto standard for any web documentation.

- The PostgreSQL[4] documentation is quite thorough and high quality.

What I think backs up your point are two things:

1. There's just a vast amount of software since those early days. "Software is eating the world", and it's realistically impossible for most of it to be well documented.

2. A lot of information is spread out in books from users of the software, on blogs, tutorials, forums, videos, etc. Sure, this might be seen as a failure of the software authors to produce good documentation, but many of these resources didn't exist before the web made them accessible. In some ways this is better than having a single source of reference, as you can benefit from the collective wisdom of the hivemind, rather than only from what the author thought relevant to document.

[1]: https://mpv.io/manual/

[2]: https://wiki.archlinux.org/

[3]: https://developer.mozilla.org/en-US/

[4]: https://www.postgresql.org/docs/

Re:We are drowning in information while starving for wisdom ... by lmm on Wednesday December 21, 2022 @07:10PM (#34088085)
Some software has good documentation nowadays. Back in the day, it was de riguer; no-one would dare to release something without a full manual, if only because they knew it was they who'd end up fielding user questions if they didn't.