| Message ID | 20251224-remove-poky-references-v1-6-658a5f4dbde2@bootlin.com |
|---|---|
| State | Superseded |
| Headers | show |
| Series | Remove obsolete poky repo references | expand |
Hi Antonin, On 12/24/25 5:31 PM, 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 | 29 +++++++++------------- > 1 file changed, 12 insertions(+), 17 deletions(-) > > diff --git a/documentation/contributor-guide/submit-changes.rst b/documentation/contributor-guide/submit-changes.rst > index 6306ed45b..d282cdf75 100644 > --- a/documentation/contributor-guide/submit-changes.rst > +++ b/documentation/contributor-guide/submit-changes.rst > @@ -429,11 +429,7 @@ 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: > +The upstream location used for submitting changes varies by component: > Everything below needs to be reworded as well as it was written with the poky combo layer in mind. Now it should be much simpler as what's within a repo can be contributed following the README from the repo? I would also add a note for the stable releases maybe? Since those aren't covered by these new rules and you need to know about those limitations (so maybe a link to that section in the older releases would be enough). > - *Core Metadata:* Send your patches to the > :oe_lists:`openembedded-core </g/openembedded-core>` > @@ -620,7 +616,7 @@ have been followed: > methods to find out: > > - *Maintenance File:* Examine the ``maintainers.inc`` file, which is > - located in the :term:`Source Directory` at > + located in :term:`OpenEmbedded-Core (OE-Core)` at > ``meta/conf/distro/include``, to see who is responsible for code. > > - *Search by File:* Using :ref:`overview-manual/development-environment:git`, you can > @@ -645,9 +641,8 @@ have been followed: > The Yocto Project provides two scripts that conveniently let you > generate and send pull requests to the Yocto Project. These scripts > are ``create-pull-request`` and ``send-pull-request``. You can find > - these scripts in the ``scripts`` directory within the > - :term:`Source Directory` (e.g. > - ``poky/scripts``). > + these scripts in the ``scripts`` directory within > + :term:`OpenEmbedded-Core (OE-Core)`. > > Using these scripts correctly formats the requests without > introducing any whitespace or HTML formatting. The maintainer that > @@ -660,7 +655,7 @@ have been followed: > directory into which you pushed the change, and provides a subject > line in the created patch files:: > > - $ poky/scripts/create-pull-request -u meta-intel-contrib -s "Updated Manual Section Reference in README" > + $ ./scripts/create-pull-request -u meta-intel-contrib -s "Updated Manual Section Reference in README" > > Running this script forms ``*.patch`` files in a folder named > ``pull-``\ `PID` in the current directory. One of the patch files is a > @@ -673,7 +668,7 @@ have been followed: > and email address. In this example, the email address is a mailing > list:: > > - $ poky/scripts/send-pull-request -p ~/meta-intel/pull-10565 -t meta-intel@lists.yoctoproject.org > + $ ./scripts/send-pull-request -p ~/meta-intel/pull-10565 -t meta-intel@lists.yoctoproject.org > > You need to follow the prompts as the script is interactive. > > @@ -682,8 +677,8 @@ have been followed: > For help on using these scripts, simply provide the ``-h`` > argument as follows:: > > - $ poky/scripts/create-pull-request -h > - $ poky/scripts/send-pull-request -h > + $ ./scripts/create-pull-request -h > + $ ./scripts/send-pull-request -h > > Submitting Changes to Stable Release Branches > ============================================= > @@ -857,14 +852,14 @@ 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. > +- *meta-yocto "master-next" branch:* This branch is part of the > + :yocto_git:`meta-yocto </meta-yocto/>` repository and combines proposed s/combines/contains/ > + changes to meta-yocto. > We also have master-next for BitBake which was handled by the poky combo layer before, so we should mention it as well. Wondering if we want to add yocto-docs there as well maybe? Not sure it's as important as the other three though. Cheers, Quentin
diff --git a/documentation/contributor-guide/submit-changes.rst b/documentation/contributor-guide/submit-changes.rst index 6306ed45b..d282cdf75 100644 --- a/documentation/contributor-guide/submit-changes.rst +++ b/documentation/contributor-guide/submit-changes.rst @@ -429,11 +429,7 @@ 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: +The upstream location used for submitting changes varies by component: - *Core Metadata:* Send your patches to the :oe_lists:`openembedded-core </g/openembedded-core>` @@ -620,7 +616,7 @@ have been followed: methods to find out: - *Maintenance File:* Examine the ``maintainers.inc`` file, which is - located in the :term:`Source Directory` at + located in :term:`OpenEmbedded-Core (OE-Core)` at ``meta/conf/distro/include``, to see who is responsible for code. - *Search by File:* Using :ref:`overview-manual/development-environment:git`, you can @@ -645,9 +641,8 @@ have been followed: The Yocto Project provides two scripts that conveniently let you generate and send pull requests to the Yocto Project. These scripts are ``create-pull-request`` and ``send-pull-request``. You can find - these scripts in the ``scripts`` directory within the - :term:`Source Directory` (e.g. - ``poky/scripts``). + these scripts in the ``scripts`` directory within + :term:`OpenEmbedded-Core (OE-Core)`. Using these scripts correctly formats the requests without introducing any whitespace or HTML formatting. The maintainer that @@ -660,7 +655,7 @@ have been followed: directory into which you pushed the change, and provides a subject line in the created patch files:: - $ poky/scripts/create-pull-request -u meta-intel-contrib -s "Updated Manual Section Reference in README" + $ ./scripts/create-pull-request -u meta-intel-contrib -s "Updated Manual Section Reference in README" Running this script forms ``*.patch`` files in a folder named ``pull-``\ `PID` in the current directory. One of the patch files is a @@ -673,7 +668,7 @@ have been followed: and email address. In this example, the email address is a mailing list:: - $ poky/scripts/send-pull-request -p ~/meta-intel/pull-10565 -t meta-intel@lists.yoctoproject.org + $ ./scripts/send-pull-request -p ~/meta-intel/pull-10565 -t meta-intel@lists.yoctoproject.org You need to follow the prompts as the script is interactive. @@ -682,8 +677,8 @@ have been followed: For help on using these scripts, simply provide the ``-h`` argument as follows:: - $ poky/scripts/create-pull-request -h - $ poky/scripts/send-pull-request -h + $ ./scripts/create-pull-request -h + $ ./scripts/send-pull-request -h Submitting Changes to Stable Release Branches ============================================= @@ -857,14 +852,14 @@ 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. +- *meta-yocto "master-next" branch:* This branch is part of the + :yocto_git:`meta-yocto </meta-yocto/>` repository and combines proposed + changes to meta-yocto. Similarly, stable branches maintained by the project may have corresponding ``-next`` branches which collect proposed changes. For example, ``&DISTRO_NAME_NO_CAP;-next`` and ``&DISTRO_NAME_NO_CAP_MINUS_ONE;-next`` -branches in both the "openembdedded-core" and "poky" repositories. +branches in both the "openembedded-core" and "meta-yocto" repositories. Other layers may have similar testing branches but there is no formal requirement or standard for these so please check the documentation for the
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 | 29 +++++++++------------- 1 file changed, 12 insertions(+), 17 deletions(-)