Outdated Documentation

First, thank you for biting, welcome :grinning_face_with_smiling_eyes:

‘The “middle school textbook” issue’ is a great new phrase, thank you for that.

Docs is a large many-headed beast, let me try and clarify your post and then answer what we can/might be able, to do.

Ubuntu documentation is absolutely the most visible, but it’s actually much more varied than you noted, you get help.ubuntu.com, but also wiki.ubuntu.com, askubuntu.com, and sometimes forums.ubuntu.com as well as specific documentation pages underneath ubuntu.com when you look for documentation/help.

The problem with it is that the vast majority of it is completely out of date (more on this later).

I would say this is not quite the problem, while there is documentation out there that is out of date,t he real problem is the up-to-date/maintained stuff is not visible/obvious. For example, the help.ubuntu.com page informs you that as of 2020 server docs moved to ubuntu.com/server/docs. But that’s not obvious to anyone if they find the docs elsewhere or don’t read this text.

Whether or not they suffer the “middle school text book” issue though is a separate topic :sweat_smile:

Ubuntu’s most visible documentation is basically a big case of document rot.

Your list here and investigation into its datedness is remarkable. And frankly unarguable.

Small business documentation? What do you mean? Can you provide a link? I’m finding a bunch of very dated Microsoft pages?

Finally, I agree with you, this isn’t going to be solved by volunteer effort alone, it needs a proper plan, and someone to drive it on the community front. I can also say that its a significant topic within Canonical to sort out for each project specifically, though I don’t know how much thought has been given to places like help.ubuntu.com so I’ll make sure to make that part of the discussion.

Before I start spouting ideas and proposals though I’d be interested to hear @gunnarhj and @dsmythies take on your comments. They certainly have a lot more context and experience than me in this area.

P.S I’m going to split this topic out so it can get more visibility.

1 Like