OK, I will bite.
The most visible resource on Ubuntu is its documentation. help.ubuntu.com articles come up in any search for information on Ubuntu.
The problem with it is that the vast majority of it is completely out of date (more on this later). While the official desktop and server guides are more up-to-date, they suffer from the “middle school text book” issue. They are correct, but if you don’t already know what you are doing, utterly useless. They may cover the concepts, but they don’t teach them to the uninitiated, nor do they provide usage models that would allow non-power users to actually do useful things.
I said the vast majority of the Ubuntu documentation is out of date. Lets quantify that.
https://help.ubuntu.com/community/Servers is one of the top level help pages. Lets go through part of that page and see what version of Ubuntu each entry was written for.
- [Basic networking] (14.04)
- [LinkAggregation] (17.10)
** Authentication **
- [OpenLDAP server] (12.04)
- [LDAP client authentication] (13.10)
- [SettingUpNISHowTo] (11.04)
- [Active Directory Authentication] (9.10)
- [Kerberos] (12.10)
- [SecurePass] (10.04)
** Wireless **
- [Wireless Access Point] (15.10)
- [Wireless Broadcast System] (7.10)
** Web servers **
- [Apache PHP MySQL] (10.04 with some 13.04 notes)
- [Highly Available LAMP Server] (9.10)
- [Ruby on Rails] (9.04)
- [Apache Tomcat 5] (6.06)
Other top level pages are no better.
The Ubuntu Community Installation Guide has not been updated since 2018.
The Application guides since 2015
The vast majority of the hardware guide since 2018
The Printer guide since 2013 (and printing has changed a LOT!!)
The scanner guide since 2019 (and I did those edits. SANE has changed a LOT in the interm…)
Network Devices since 2012
I could go on, but the point is Ubuntu’s most visible documentation is basically a big case of document rot.
The use of business models would help a lot. See the Small Business Server documentation as an example.
Unfortunately, I don’t think this is going to be solved by a volunteer effort. While I am willing to put some volunteer time in, the documentation side needs a complete re-think.
Updating documentation is a LOT of WORK! And its not “fun” work (if it were, it would be updated).