Randy Dunlap <rdunlap@xxxxxxxxxxxxx> writes: > On 11/7/24 12:45 PM, Jonathan Corbet wrote: >> anish kumar <yesanishhere@xxxxxxxxx> writes: >> >>> Add a comprehensive debugging guide for ALSA audio issues, covering >>> topics from bootup to runtime debugging. This document aims to help >>> developers diagnose and resolve common audio problems in Linux. >>> >>> The guide includes sections on: >>> - Bootup/bringup issues >>> - Runtime debugging >>> - XRUN debugging >>> - Audio pops and clicks >>> >>> This addresses the lack of a centralized debugging resource for ALSA >>> and should help improve the troubleshooting process for audio drivers. >>> >>> Inspired by discussions on LKML: >>> https://lkml.org/lkml/2024/9/24/392 >>> >>> Signed-off-by: anish kumar <yesanishhere@xxxxxxxxx> >>> --- >>> Documentation/sound/soc/debug.rst | 334 ++++++++++++++++++++++++++++++ >>> Documentation/sound/soc/index.rst | 1 + >>> 2 files changed, 335 insertions(+) >>> create mode 100644 Documentation/sound/soc/debug.rst >> >> At a first glance, this seems useful. >> >> I was just looking at Sebastian's new debugging documentation: >> >> https://lore.kernel.org/all/20241028-media_docs_improve_v3-v1-0-2b1b486c223e@xxxxxxxxxxxxx/ >> >> ... so my immediate thought is that this documentation should be >> coherent and together, rather than scattered though the docs. Maybe >> move this to process/debugging and integrate it with his work? > > and once again I disagree that these docs should be in Documentation/process/. OK, I guess I missed that...where do you think we should put them? jon
