Re: [docs] [PATCH v2] migration-guides: add release notes for 5.0.16

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

Hi,

On Wed Mar 18, 2026 at 11:09 AM CET, Lee Chee Yang via lists.yoctoproject.org wrote:
> From: Lee Chee Yang <chee.yang.lee@intel.com>
>
> Signed-off-by: Lee Chee Yang <chee.yang.lee@intel.com>
> ---
> v2 : reworded highlight notes and known issue.
>
>  .../migration-guides/release-5.0.rst          |   1 +
>  .../migration-guides/release-notes-5.0.16.rst | 218 ++++++++++++++++++
>  2 files changed, 219 insertions(+)
>  create mode 100644 documentation/migration-guides/release-notes-5.0.16.rst
>
> diff --git a/documentation/migration-guides/release-5.0.rst b/documentation/migration-guides/release-5.0.rst
> index 63b23edb1..b98e0141c 100644
> --- a/documentation/migration-guides/release-5.0.rst
> +++ b/documentation/migration-guides/release-5.0.rst
> @@ -22,3 +22,4 @@ Release 5.0 (scarthgap)
>     release-notes-5.0.13
>     release-notes-5.0.14
>     release-notes-5.0.15
> +   release-notes-5.0.16
> diff --git a/documentation/migration-guides/release-notes-5.0.16.rst b/documentation/migration-guides/release-notes-5.0.16.rst
> new file mode 100644
> index 000000000..da069f8bd
> --- /dev/null
> +++ b/documentation/migration-guides/release-notes-5.0.16.rst
> @@ -0,0 +1,218 @@
> +Release notes for Yocto-5.0.16 (Scarthgap)
> +------------------------------------------
> +
> +This release breaks Ubuntu 20.04 as a
> +:ref:`compatible host <ref-manual/system-requirements:Supported Linux Distributions>`.
> +Ubuntu 20.04 lack kernel header recent enough to support the 
> +:ref:`pseudo <overview-manual/concepts:fakeroot and pseudo>` fixes.
> +Ubuntu 20.04 is End-of-Life since 31 May 2025. Impacted users are encouragded to upgrade

s/encouragded/encouraged/

> +to a actively supported host ditribution. See :doc:`/ref-manual/system-requirements`
> +for more information on compatible hosts.

I think you fixed the first sentence but there are still the same problems/typos
for the remaining ones.

I'll copy again here what I was suggesting:

"""
This release breaks support for Ubuntu 20.04 as a :ref:`compatible host
<ref-manual/system-requirements:Supported Linux Distributions>`. The Ubuntu 20.04
Linux kernel headers are not recent enough to support the latest :ref:`pseudo
<overview-manual/concepts:fakeroot and pseudo>` fixes.

Ubuntu 20.04 is End-of-Life since 31 May 2025. Impacted users are encouraged to
upgrade to an actively supported host distribution. See
:doc:`/ref-manual/system-requirements` for more information on compatible hosts.
"""

I've merged this patch with this updated paragraph. Please let me know if you
disagree with any of the above changes.

Full diff:

diff --git a/documentation/migration-guides/release-notes-5.0.16.rst b/documentation/migration-guides/release-notes-5.0.16.rst
index da069f8bd..09f37c302 100644
--- a/documentation/migration-guides/release-notes-5.0.16.rst
+++ b/documentation/migration-guides/release-notes-5.0.16.rst
@@ -1,19 +1,20 @@
 Release notes for Yocto-5.0.16 (Scarthgap)
 ------------------------------------------
 
-This release breaks Ubuntu 20.04 as a
-:ref:`compatible host <ref-manual/system-requirements:Supported Linux Distributions>`.
-Ubuntu 20.04 lack kernel header recent enough to support the 
-:ref:`pseudo <overview-manual/concepts:fakeroot and pseudo>` fixes.
-Ubuntu 20.04 is End-of-Life since 31 May 2025. Impacted users are encouragded to upgrade
-to a actively supported host ditribution. See :doc:`/ref-manual/system-requirements`
-for more information on compatible hosts.
+This release breaks support for Ubuntu 20.04 as a :ref:`compatible host
+<ref-manual/system-requirements:Supported Linux Distributions>`. The Ubuntu 20.04
+Linux kernel headers are not recent enough to support the latest :ref:`pseudo
+<overview-manual/concepts:fakeroot and pseudo>` fixes.
+
+Ubuntu 20.04 is End-of-Life since 31 May 2025. Impacted users are encouraged to
+upgrade to an actively supported host distribution. See
+:doc:`/ref-manual/system-requirements` for more information on compatible hosts.
 
 Alternatively, a fix has been merged to scarthgap branch and can be applied on top of this
 release:
 
-- :oe_git:`/openembedded-core/commit/?h=scarthgap&id=fe2666749094e896736ff24d6885419905488723`
-- :yocto_git:`/poky/commit/?h=scarthgap&id=65c3ebea05dde5cbc9d249e7949fabbc0047313e`
+-  :oe_git:`/openembedded-core/commit/?h=scarthgap&id=fe2666749094e896736ff24d6885419905488723`
+-  :yocto_git:`/poky/commit/?h=scarthgap&id=65c3ebea05dde5cbc9d249e7949fabbc0047313e`
 
 
 Security Fixes in Yocto-5.0.16
@@ -97,8 +98,8 @@ Known Issues in Yocto-5.0.16
 The poky :term:`DISTRO_VERSION` was incorrectly left at 5.0.15. This is a minor
 issue, if a workaround is needed please cherry-pick:
 
-- poky commit :yocto_git:`/poky/commit/?h=scarthgap&id=06210079b2e10d6d3fb943afe87864267e329821`
-- meta-yocto commit :yocto_git:`/meta-yocto/commit/?h=scarthgap&id=03f93c769ec99e5086e492d8145eb308a718e8d3`
+-  poky commit :yocto_git:`/poky/commit/?h=scarthgap&id=06210079b2e10d6d3fb943afe87864267e329821`
+-  meta-yocto commit :yocto_git:`/meta-yocto/commit/?h=scarthgap&id=03f93c769ec99e5086e492d8145eb308a718e8d3`
 
 
 Contributors to Yocto-5.0.16


Thanks,
Antonin