aboutsummaryrefslogtreecommitdiff
path: root/docs/design/2026-07-10-audio-failure-taxonomy.org
Commit message (Collapse)AuthorAgeFilesLines
* docs: catalogue Linux audio input and output failure modesCraig Jennings2026-07-101-0/+190
This catalogues real, user-reported ways the microphone and speakers fail on Linux, to feed the audio doctor's triage. It holds 58 input and 59 output distinct root causes, across eight layers each: kernel/driver/firmware, ALSA, PipeWire, Bluetooth, HDMI, USB, app/portal, hardware. Every entry carries its symptom, cause, concrete fix, a sudo/reboot tag, and a source. The sudo/reboot tag is the triage lever. A no-sudo, no-reboot fix is a candidate for a doctor remedy. A firmware, BIOS, or physical fix can only ever be a printed instruction. Triage into build, guide, or out is the next pass.