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

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 :)

> As a consequence, rename the first section title and reword the intro.
> 
> Signed-off-by: Antonin Godard <[email protected]>
> ---
>   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)"?

>   |
>   
> 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?

> +================
>   
> -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 :/

Cheers,
Quentin