← Back to team overview

ubuntu-audio-dev team mailing list archive

Sound troubleshooting documentation


Hi ubuntu-doc team (ubuntu-audio-dev cc:ed),

There are several guides for sound troubleshooting on help.ubuntu.com:


In addition to the more official documentation at


...which I recently made up-to-date.

In short, we don't need four pages. In addition, I'm worried about the quality:


This seems to be the best of the three, even if a few things needs fixing. It also has some nice screenshots, and some of this could actually be copy-pasted into the official documentation.


This one seems less maintained than the other two, and is a little of a mixed bag of correct information, outdated information, and things that can break your system. It is also a mixup of generic instructions and machine specific workarounds, which I'd prefer to keep separate if possible.


This one contains random steps and terminal commands to execute, with very little information about what command is to aid what problem. And for information collection, we have better scripts/instructions to do that, both in the wiki [1] and through apport.

Especially for the last page, I'd prefer to remove it altogether, but I also realise that someone has put a lot of effort in writing and maintaining that information. I don't want to step on anyone's toes, but of course I don't want people to break their systems either.

What do you suggest? How can we improve the quality of the sound troubleshooting documentation?

David Henningsson, Canonical Ltd.

[1] https://wiki.ubuntu.com/Audio/AlsaInfo and https://wiki.ubuntu.com/PulseAudio/Log

Follow ups