Re: [PATCH 1/2] docs: Add guides section for debugging

From: Randy Dunlap
Date: Thu Nov 07 2024 - 16:25:20 EST


Hi,

On 11/7/24 12:35 PM, Jonathan Corbet wrote:
> Sebastian Fricke <sebastian.fricke@xxxxxxxxxxxxx> writes:
>
>> This idea was formed after noticing that new developers experience
>> certain difficulty to navigate within the multitude of different
>> debugging options in the Kernel and while there often is good
>> documentation for the tools, the developer has to know first that they
>> exist and where to find them.
>> Add a general debugging section to the Kernel documentation, as an
>> easily locatable entry point to other documentation and as a general
>> guideline for the topic.
>>
>> Signed-off-by: Sebastian Fricke <sebastian.fricke@xxxxxxxxxxxxx>
>> ---
>> Documentation/index.rst | 2 +
>> .../driver_development_debugging_guide.rst | 206 +++++++++++++++
>> Documentation/process/debugging/general_advice.rst | 48 ++++
>> Documentation/process/debugging/index.rst | 21 ++
>> .../debugging/userspace_debugging_guide.rst | 278 +++++++++++++++++++++
>> 5 files changed, 555 insertions(+)
>>

You two have probably already gone over this, but I would not go
looking into Documentation/process/ at all for debugging advice.

IOW, I think that these docs belong somewhere else.


--
~Randy