> What it was "optimized for" is irrelevant if it's legible and has good information.
It's not having good information that is important, what's critical is finding relevant information quickly, tagging and linking it to other parts of the document and external sources. Also information does not have to be limited to text format, especially for manuals a graphic or a small video can be worth more than thousand written words. Welcome to 21st century. All information you'll ever need is present in the source code, then why even bother creating a documentation? Manpage is limited for even text terminals, texinfo is so much better.
I agree regarding the need to keep the documentation updated. However, it's quite easy to get support from the community and putting a request to update an outdated article or section.
It's not having good information that is important, what's critical is finding relevant information quickly, tagging and linking it to other parts of the document and external sources. Also information does not have to be limited to text format, especially for manuals a graphic or a small video can be worth more than thousand written words. Welcome to 21st century. All information you'll ever need is present in the source code, then why even bother creating a documentation? Manpage is limited for even text terminals, texinfo is so much better.
I agree regarding the need to keep the documentation updated. However, it's quite easy to get support from the community and putting a request to update an outdated article or section.