In a recent post on his blog, our wonderful community leader Jono describes several internship positions within the Ubuntu Community team, one of them being "Ubuntu Community Documentation Author." One of the responsibilities is to "Work with the Ubuntu Documentation Team, Learning Team, and Ubuntu manual project to liaise around collaboration and best practise for materials production." This blog post is a response.
The problem is this is yet another example of ignoring the current community and its current workflow/structure. I’ve been working on the Ubuntu Documentation Team since the very earliest of days,including the ubuntu-doc mailing list, spending time in #ubuntu-doc, etc and don’t ever recall a discussion w/ people in this group on what they are currently working on, what the current standards are and what the current best practices are. The Ubuntu Doc team has an established Style Guide, a workflow and also very established teams, including a way of moving from non-committer to having commit access.
The other frustration is this is not the first time the Doc Team has been ignored. Out of the blue came the announcement of the "Official Ubuntu Manual" and it’s blessing by the Community Manager without discussing or even mentioning it to the Doc Team. The compliant that drove the creation of the Ubuntu Manual is the current help system is not printable in a book or manual format. A while ago the Doc Team had quite the discussion on whether or not to switch from the current format (able to be printed out and used as a manual) to the current format (topic based). This switch was hotly debated and you can look through ubuntu-doc mailing list to see exactly what was talked about. However it seems no research was done about this. One day this appeared on the on the scene blessed and ready to go as another official project.
I know this seems as a big rant but a lot of the community was ignored in the creation of this position. The doc-team is a group that most people don’t know about but we spend a lot of time and hard work to create the best system documentation possible to allow you (the user) to use and understand how to use your system to its full potential. Spend sometime on #ubuntu-doc or the ubuntu-doc mailing list (email@example.com) to figure out how the community works and join in the fun