public inbox for docs@lists.yoctoproject.org
 help / color / mirror / Atom feed
From: Quentin Schulz <quentin.schulz@cherry.de>
To: antonin.godard@bootlin.com, docs@lists.yoctoproject.org
Cc: Thomas Petazzoni <thomas.petazzoni@bootlin.com>
Subject: Re: [docs] [PATCH v2 06/56] contributor-guide/submit-changes.rst: remove obsolete poky repo references
Date: Tue, 27 Jan 2026 14:37:56 +0100	[thread overview]
Message-ID: <02def239-7fbe-4fbb-a78b-919b1d8a4c45@cherry.de> (raw)
In-Reply-To: <20260127-remove-poky-references-v2-6-74bf80cc4e5a@bootlin.com>

Hi Antonin,

On 1/27/26 9:19 AM, Antonin Godard via lists.yoctoproject.org wrote:
> Remove references to the Poky repository, replace by OpenEmbedded-Core
> in most cases.
> 
> Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
> ---
>   documentation/contributor-guide/submit-changes.rst | 57 ++++++----------------
>   1 file changed, 14 insertions(+), 43 deletions(-)
> 
> diff --git a/documentation/contributor-guide/submit-changes.rst b/documentation/contributor-guide/submit-changes.rst
> index 07989d7b6..4a4c60b41 100644
> --- a/documentation/contributor-guide/submit-changes.rst
> +++ b/documentation/contributor-guide/submit-changes.rst
> @@ -429,37 +429,6 @@ and then based on successful testing, merges them.
>   In general, each component (e.g. layer) should have a ``README`` file
>   that indicates where to send the changes and which process to follow.
>   
> -The "poky" repository, which is the Yocto Project's reference build
> -environment, is a hybrid repository that contains several individual
> -pieces (e.g. BitBake, Metadata, documentation, and so forth) built using
> -the combo-layer tool. The upstream location used for submitting changes
> -varies by component:
> -
> --  *Core Metadata:* Send your patches to the
> -   :oe_lists:`openembedded-core </g/openembedded-core>`
> -   mailing list. For example, a change to anything under the ``meta`` or
> -   ``scripts`` directories should be sent to this mailing list.
> -
> --  *BitBake:* For changes to BitBake (i.e. anything under the
> -   ``bitbake`` directory), send your patches to the
> -   :oe_lists:`bitbake-devel </g/bitbake-devel>`
> -   mailing list.
> -
> --  *meta-poky* and *meta-yocto-bsp* trees: These trees contain Metadata. Use the
> -   :yocto_lists:`poky </g/poky>` mailing list.
> -
> --  *Documentation*: For changes to the Yocto Project documentation, use the
> -   :yocto_lists:`docs </g/docs>` mailing list.
> -
> -For changes to other layers and tools hosted in the Yocto Project source
> -repositories (i.e. :yocto_git:`git.yoctoproject.org <>`), use the
> -:yocto_lists:`yocto-patches </g/yocto-patches/>` general mailing list.
> -
> -For changes to other layers hosted in the OpenEmbedded source
> -repositories (i.e. :oe_git:`git.openembedded.org <>`), use
> -the :oe_lists:`openembedded-devel </g/openembedded-devel>`
> -mailing list, unless specified otherwise in the layer's ``README`` file.
> -
>   If you intend to submit a new recipe that neither fits into the core Metadata,

In this patch, we just removed what we meant by Core Metadata, so now 
this can be quite confusing. Should we simply state OpenEmbedded-Core?

Also, how does one knows if the recipe can fit into OE-Core? (we do have 
some rules as to what's acceptable, must be a direct and default 
dependency of some other recipe in OE-Core, or with a demonstrable 
valuable benefit for OE-Core).

[...]

> @@ -857,14 +825,17 @@ used testing branches for OpenEmbedded-Core are as follows:
>      :oe_git:`openembedded-core </openembedded-core/>` repository and contains
>      proposed changes to the core metadata.
>   
> --  *poky "master-next" branch:* This branch is part of the
> -   :yocto_git:`poky </poky/>` repository and combines proposed
> -   changes to BitBake, the core metadata and the poky distro.
> +- *bitbake "master-next" branch:* This branch is part of the :oe_git:`bitbake
> +  </bitbake/>` repository and contains changes to :term:`BitBake`.
> +

Missing a (second) whitespace after - in the first line and a third 
whitespace in the second line.

Cheers,
Quentin


  reply	other threads:[~2026-01-27 13:38 UTC|newest]

Thread overview: 92+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2026-01-27  8:18 [PATCH v2 00/56] Remove obsolete poky repo references Antonin Godard
2026-01-27  8:18 ` [PATCH v2 01/56] transitioning-to-a-custom-environment.rst: remove " Antonin Godard
2026-01-27  8:18 ` [PATCH v2 02/56] dev-manual/poky-manual-setup.rst: " Antonin Godard
2026-01-27 10:55   ` [docs] " Quentin Schulz
2026-01-27  8:18 ` [PATCH v2 03/56] dev-manual/start.rst: " Antonin Godard
2026-01-27 11:14   ` [docs] " Quentin Schulz
2026-01-27  8:18 ` [PATCH v2 04/56] bsp-guide/bsp.rst: " Antonin Godard
2026-01-27 11:27   ` [docs] " Quentin Schulz
2026-01-29 11:17     ` Antonin Godard
2026-01-27  8:19 ` [PATCH v2 05/56] kernel-dev/advanced.rst: " Antonin Godard
2026-01-27 13:05   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 06/56] contributor-guide/submit-changes.rst: " Antonin Godard
2026-01-27 13:37   ` Quentin Schulz [this message]
2026-01-27  8:19 ` [PATCH v2 07/56] dev-manual/building.rst: " Antonin Godard
2026-01-27  8:19 ` [PATCH v2 08/56] dev-manual/debugging.rst: " Antonin Godard
2026-01-27  8:19 ` [PATCH v2 09/56] dev-manual/error-reporting-tool.rst: " Antonin Godard
2026-01-27  8:19 ` [PATCH v2 10/56] dev-manual/external-toolchain.rst: " Antonin Godard
2026-01-27  8:19 ` [PATCH v2 11/56] dev-manual/layers.rst: " Antonin Godard
2026-01-27 15:18   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 12/56] " Antonin Godard
2026-01-27 15:29   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 13/56] dev-manual/libraries.rst: " Antonin Godard
2026-01-27  8:19 ` [PATCH v2 14/56] dev-manual/new-recipe.rst: " Antonin Godard
2026-01-27 15:39   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 15/56] dev-manual/securing-images.rst: " Antonin Godard
2026-01-27 15:44   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 16/56] dev-manual/temporary-source-code.rst: " Antonin Godard
2026-01-27  8:19 ` [PATCH v2 17/56] dev-manual/wayland.rst: " Antonin Godard
2026-01-27  8:19 ` [PATCH v2 18/56] dev-manual/wic.rst: " Antonin Godard
2026-01-27  8:19 ` [PATCH v2 19/56] kernel-dev/common.rst: " Antonin Godard
2026-01-27 17:41   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 20/56] migration-guides/migration-1.4.rst: " Antonin Godard
2026-01-27  8:19 ` [PATCH v2 21/56] overview-manual/concepts.rst: " Antonin Godard
2026-01-27 17:58   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 22/56] overview-manual/development-environment.rst: " Antonin Godard
2026-01-28 11:11   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 23/56] overview-manual/yp-intro.rst: " Antonin Godard
2026-01-28 11:32   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 24/56] ref-manual/classes.rst: " Antonin Godard
2026-01-27  8:19 ` [PATCH v2 25/56] ref-manual/images.rst: " Antonin Godard
2026-01-27  8:19 ` [PATCH v2 26/56] ref-manual/structure.rst: " Antonin Godard
2026-01-28 11:48   ` [docs] " Quentin Schulz
2026-01-29 14:11     ` Antonin Godard
2026-01-27  8:19 ` [PATCH v2 27/56] ref-manual/tasks.rst: " Antonin Godard
2026-01-27  8:19 ` [PATCH v2 28/56] ref-manual/variables.rst: " Antonin Godard
2026-01-28 13:36   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 29/56] sdk-manual/appendix-obtain.rst: " Antonin Godard
2026-01-28 13:36   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 30/56] sdk-manual/intro.rst: " Antonin Godard
2026-01-27  8:19 ` [PATCH v2 31/56] test-manual/runtime-testing.rst: " Antonin Godard
2026-01-27  8:19 ` [PATCH v2 32/56] README: " Antonin Godard
2026-01-28 13:40   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 33/56] README: replace obsolete substitution variables Antonin Godard
2026-01-27  8:19 ` [PATCH v2 34/56] contributor-guide/identify-component.rst: remove obsolete poky repo references Antonin Godard
2026-01-27  8:19 ` [PATCH v2 35/56] dev-manual/build-quality.rst: " Antonin Godard
2026-01-28 13:41   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 36/56] dev-manual/custom-distribution.rst: " Antonin Godard
2026-01-27  8:19 ` [PATCH v2 37/56] dev-manual/custom-template-configuration-directory.rst: " Antonin Godard
2026-01-28 13:47   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 38/56] dev-manual/init-manager.rst: " Antonin Godard
2026-01-27  8:19 ` [PATCH v2 39/56] dev-manual/licenses.rst: " Antonin Godard
2026-01-28 13:54   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 40/56] dev-manual/licenses.rst: instruct to use git-archive instead of removing .git Antonin Godard
2026-01-28 13:57   ` Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 41/56] dev-manual/packages.rst: remove obsolete poky repo references Antonin Godard
2026-01-28 14:01   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 42/56] dev-manual/python-development-shell.rst: " Antonin Godard
2026-01-28 14:02   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 43/56] dev-manual/qemu.rst: " Antonin Godard
2026-01-28 14:03   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 44/56] dev-manual/upgrading-recipes.rst: " Antonin Godard
2026-01-28 14:09   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 45/56] dev-manual/vulnerabilities.rst: " Antonin Godard
2026-01-28 14:11   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 46/56] ref-manual/devtool-reference.rst: " Antonin Godard
2026-01-28 14:15   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 47/56] ref-manual/faq.rst: " Antonin Godard
2026-01-28 14:23   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 48/56] ref-manual/features.rst: " Antonin Godard
2026-01-27  8:19 ` [PATCH v2 49/56] ref-manual/release-process.rst: " Antonin Godard
2026-01-27  8:19 ` [PATCH v2 50/56] ref-manual/release-process.rst: remove repeated "in the" Antonin Godard
2026-01-28 14:27   ` Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 51/56] ref-manual/system-requirements.rst: remove obsolete poky repo references Antonin Godard
2026-01-28 14:48   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 52/56] ref-manual/system-requirements.rst: fix wrong path to install-buildtools Antonin Godard
2026-01-28 15:02   ` Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 53/56] ref-manual/yocto-project-supported-features.rst: remove obsolete poky repo reference Antonin Godard
2026-01-27  8:19 ` [PATCH v2 54/56] test-manual/reproducible-builds.rst: remove obsolete poky repo references Antonin Godard
2026-01-27  8:19 ` [PATCH v2 55/56] test-manual/understand-autobuilder.rst: " Antonin Godard
2026-01-28 15:03   ` [docs] " Quentin Schulz
2026-01-27  8:19 ` [PATCH v2 56/56] what-i-wish-id-known.rst: " Antonin Godard
2026-01-28 15:08   ` [docs] " Quentin Schulz

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=02def239-7fbe-4fbb-a78b-919b1d8a4c45@cherry.de \
    --to=quentin.schulz@cherry.de \
    --cc=antonin.godard@bootlin.com \
    --cc=docs@lists.yoctoproject.org \
    --cc=thomas.petazzoni@bootlin.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox