Re: [docs] [PATCH] migration-guide: update 5.3 release notes download section

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

Hi,

On Tue Dec 16, 2025 at 3:33 PM CET, Lee Chee Yang via lists.yoctoproject.org wrote:
> From: Lee Chee Yang <chee.yang.lee@intel.com>
>
> also align some note with finalized release notes.
>
> Signed-off-by: Lee Chee Yang <chee.yang.lee@intel.com>
> ---
>  .../migration-guides/release-notes-5.3.rst    | 90 +++++++++++++++++--
>  1 file changed, 83 insertions(+), 7 deletions(-)
>
> diff --git a/documentation/migration-guides/release-notes-5.3.rst b/documentation/migration-guides/release-notes-5.3.rst
> index 536067d63..7e41bc862 100644
> --- a/documentation/migration-guides/release-notes-5.3.rst
> +++ b/documentation/migration-guides/release-notes-5.3.rst
> @@ -8,6 +8,15 @@
>  Release notes for |yocto-ver| (|yocto-codename|)
>  ------------------------------------------------
>  
> +This release does have some significant changes which people need to be aware
> +of. We have added bitbake-setup and have switched to this as the default way
> +the project is presented to users (e.g. in our documentation and in our
> +automated testing). Existing workflows with other tools such as kas or
> +submodules, or individual repositories remain unchanged. We have stopped
> +updating the poky repository and users will need to switch to the individual
> +bitbake, openembedded-core, meta-yocto and yocto-docs repositories instead
> +though. Please see :yocto_git:`README </poky/tree/README>` for more information.

I believe all of this was already addressed in the migration guide
(https://docs.yoctoproject.org/dev/migration-guides/migration-5.3.html),
so this seems redundant? Could we simplify to:

"""
This release does have significant changes which people need to be aware of. See
:doc:`/migration-guides/migration-5.3` for more information.
"""

Antonin

-- 
Antonin Godard, Bootlin
Embedded Linux and Kernel engineering
https://bootlin.com