Re: [docs] [PATCH 4/5] sdk-manual: rename the section to remove "extensible"

["Antonin Godard" <antonin.godard@bootlin.com>]

Hi,

On Thu Jul 30, 2026 at 12:29 PM CEST, Quentin Schulz wrote:
> Hi Antonin,
>
> On 7/29/26 12:02 PM, Antonin Godard via lists.yoctoproject.org wrote:
>> The SDK manual covers both the standard and extensible SDKs yet the
>> title does not imply that, so rename the section to "Yocto Project
>> Application Development and the Software Development Kit (SDK) Manual".
>> 
>
> Well, now it's the opposite :)

Not sure we understand this the same way, for me "SDK" could me either standard
or extensible.

>> As a consequence, rename the first section title and reword the intro.
>> 
>> Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
>> ---
>>   documentation/index.rst            | 2 +-
>>   documentation/sdk-manual/index.rst | 6 +++---
>>   documentation/sdk-manual/intro.rst | 8 ++++----
>>   3 files changed, 8 insertions(+), 8 deletions(-)
>> 
>> diff --git a/documentation/index.rst b/documentation/index.rst
>> index afabb6615..d8603c2f5 100644
>> --- a/documentation/index.rst
>> +++ b/documentation/index.rst
>> @@ -67,7 +67,7 @@ infrastructure.
>>      Linux Kernel Development Manual <kernel-dev/index>
>>      Security Manual <security-manual/index>
>>      Profile and Tracing Manual <profile-manual/index>
>> -   Application Development and the Extensible SDK (eSDK) <sdk-manual/index>
>> +   Application Development and SDK Manual <sdk-manual/index>
>>      Toaster Manual <toaster-manual/index>
>>      Test Environment Manual <test-manual/index>
>>      BitBake User Manual <bitbake>
>> diff --git a/documentation/sdk-manual/index.rst b/documentation/sdk-manual/index.rst
>> index dc7186b91..477274ab9 100644
>> --- a/documentation/sdk-manual/index.rst
>> +++ b/documentation/sdk-manual/index.rst
>> @@ -1,8 +1,8 @@
>>   .. SPDX-License-Identifier: CC-BY-SA-2.0-UK
>>   
>> -========================================================================================
>> -Yocto Project Application Development and the Extensible Software Development Kit (eSDK)
>> -========================================================================================
>> +===================================================================================
>> +Yocto Project Application Development and the Software Development Kit (SDK) Manual
>> +===================================================================================
>>   
>
> Maybe "Software Development Kits (SDK/eSDK)"?

I like this too, makes it extra clear, I'll go with:

"Application Development and Software Development Kits (SDK/eSDK) Manual"

>>   |
>>   
>> diff --git a/documentation/sdk-manual/intro.rst b/documentation/sdk-manual/intro.rst
>> index 53246bd9a..8ccbcfa20 100644
>> --- a/documentation/sdk-manual/intro.rst
>> +++ b/documentation/sdk-manual/intro.rst
>> @@ -4,11 +4,11 @@
>>   Introduction
>>   ************
>>   
>> -eSDK Introduction
>> -=================
>> +SDK Introduction
>
> SDK/eSDK?

Or just "Introduction" :)

>> +================
>>   
>> -Welcome to the Yocto Project Application Development and the Extensible
>> -Software Development Kit (eSDK) manual. This manual
>> +Welcome to the Yocto Project Application Development and the
>> +Software Development Kit (SDK) manual. This manual
>
> Ditto.
>
> It's a bit confusing to use SDK as 'either "standard" SDK or eSDK' and 
> also '"standard" SDK'. I don't have anything to suggest though :/

With the new title this should fix the issue.

Antonin