Re: [RFC PATCH] ALSA: Add debugging guide for audio issues

[Randy Dunlap <rdunlap@xxxxxxxxxxxxx>]

On 11/7/24 2:25 PM, Jonathan Corbet wrote:
> Randy Dunlap <rdunlap@xxxxxxxxxxxxx> writes:
> 
>> I see a few possibilities, none perfect:
>>
>> a. in Documentation/driver-api/debug/  [not quite driver-api though]
> 
> No, it's not API stuff, and not limited to drivers.
> 
>> b. in Documentation/core-api/ along with debugging-via-ohci1394.rst
>> [maybe in a new /debug/ subdir]
> 
> Again, not really API stuff.
> 
>> c. in (new) Documentation/debug/ and invite the kernel debugging
>> community to add some of their docs here as well.
> 
> If we really want to separate the mechanics of kernel development from
> the associated process information - not always an easy separation, IMO
> - we could make a top-level "development" directory, put a lot of the
> other relevant stuff there, and include the debugging stuff.  It seems
> really weird to put debugging by itself, though; it's only part of the
> picture.

I could go with that.

> 
> Why is Documentation/process so bad?

Documentation/process/ is meta-documentation about kernel social "standards"
among other things. It is "soft" documentation, whereas debugging (IMHO) is
"hard" documentation.

But hey, it's all your baby. Do whatever pleases you. :)

-- 
~Randy