Re: [docs] [PATCH 03/53] dev-manual/poky-manual-setup.rst: remove obsolete poky repo references

[Quentin Schulz <quentin.schulz@cherry.de>]

Hi Antonin,

On 12/24/25 5:31 PM, Antonin Godard via lists.yoctoproject.org wrote:
> The commit "dev-manual/start.rst: simplify the document after poky
> obsolescence" removed some of the information related to source archives
> published on downloads.yoctoproject.org. Mention it in this document as
> it makes sense to use those when manually setting up a Poky build.
> 

Do the opposite? Have this commit before we remove the important parts 
in the commit you mention? So that no information is temporarily lost?

> Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
> ---
>   documentation/dev-manual/poky-manual-setup.rst | 28 +++++++++++++++++++++++++-
>   1 file changed, 27 insertions(+), 1 deletion(-)
> 
> diff --git a/documentation/dev-manual/poky-manual-setup.rst b/documentation/dev-manual/poky-manual-setup.rst
> index 7ee084007..c4e36ce8b 100644
> --- a/documentation/dev-manual/poky-manual-setup.rst
> +++ b/documentation/dev-manual/poky-manual-setup.rst
> @@ -13,8 +13,15 @@ document guides through this setup step-by-step.
>      :doc:`/brief-yoctoprojectqs/index`, which shows how to setup :term:`Poky`
>      with ``bitbake-setup``.
>   
> +Obtaining The Source Repositories
> +=================================
> +
> +You can obtain the source repositories required to build the Poky reference
> +distro in two ways described below: cloning the repositories with Git, or
> +downloading the released archives.
> +

suggestion: Use cross-reference links for both (linking to "Use Git to 
Clone the Layers and Using the Source Archives).

>   Use Git to Clone The Layers
> -===========================
> +---------------------------
>   
>   Go to the :yocto_home:`Releases </development/releases/>` page, and choose a release
>   (such as ``&DISTRO_REL_LATEST_TAG;``), corresponding to either the latest stable
> @@ -41,6 +48,25 @@ following commands:
>      $ git clone -b &DISTRO_REL_LATEST_TAG; https://git.openembedded.org/openembedded-core ./layers/openembedded-core
>      $ git clone -b &DISTRO_REL_LATEST_TAG; https://git.yoctoproject.org/meta-yocto ./layers/meta-yocto
>   
> +
> +Using the Source Archives
> +-------------------------
> +
> +The Yocto Project also provides source archives of its releases, which
> +are available on :yocto_dl:`/releases/yocto/`. Then, choose the subdirectory

s/on/at/ ?

> +containing the release you wish to use, for example
> +:yocto_dl:`&DISTRO_REL_LATEST_TAG; </releases/yocto/&DISTRO_REL_LATEST_TAG;/>`.
> +
> +You will find there source archives of individual components (if you wish
> +to use them individually), and of the corresponding Poky release bundling
> +a selection of these components.
> +

Where it this poky bundle, I cannot find it here: 
https://downloads.yoctoproject.org/releases/yocto/yocto-5.3/

> +.. note::
> +
> +   The recommended method for accessing Yocto Project components is to
> +   use Git to clone the upstream repository and work from within that

suggestion: Use a cross-reference link pointing at the section above 
this one.

> +   locally cloned repository.
> +

s/that locally cloned repository/the locally cloned repositories/

(no combo layer anymore!).

Cheers,
Quentin