Does Ubuntu Care About It's Documentation?

[Rocco Stanzione]

On Tuesday 14 March 2006 08:06, Michael T. Richter wrote:
> Would you care to point me to the good docs (on-board or otherwise)
> which explain how to set up and configure ALSA?  Or Bluetooth?  Because
> the docs for both of these are terrible.
>
> And before someone points me to the Bluetooth walkthrough on the Wiki,
> please note that by "good docs" I mean "docs which are complete".
> Complete docs handle the exceptional cases, not just the ones you can
> follow step-by-step and assume all goes as listed.  (So, "you should see
> <foo>" should be followed by "should you not see <foo> here is what you
> do"-style assistance in good docs.)

The docs are maintained by both the doc team and, in the case of the wiki, the 
community at large.  Again, if you'd like to be constructive, complete the 
docs.  Personally, I'm very impressed with the quantity and quality of 
documentation that's accumulated for Ubuntu in such a short time.  I think it 
compares favorably to the Gentoo documentation, which is famously good and 
plentiful.  Obviously it still needs work, and that's never going to change.  
Individual documents may become "complete", but the documentation of an 
open-source operating system with thousands of packages, most of which are in 
constant flux, cannot ever really be completed - certainly not for an 
operating system on a 6-month release cycle.

So, again, if you think a doc is incomplete, complete it.  Trolling about it 
is not likely to solve anything.

Rocco Stanzione