| Message ID | 20230228221309.82156-2-yoann.congal@smile.fr |
|---|---|
| State | New |
| Headers | show |
| Series | ref-manual: Add info on "mixin" layers | expand |
Hi Yoann Many thanks for the patch! On 28.02.23 at 23:13, Yoann Congal wrote: > This is heavily inspired from: > https://wiki.yoctoproject.org/wiki/index.php?title=Stable_Release_and_LTS&oldid=84847#LTS_.E2.80.9CMixin.E2.80.9D_repositories > > Signed-off-by: Yoann Congal <yoann.congal@smile.fr> > --- > documentation/ref-manual/release-process.rst | 15 +++++++++++++++ > 1 file changed, 15 insertions(+) > > diff --git a/documentation/ref-manual/release-process.rst b/documentation/ref-manual/release-process.rst > index 19e804063..cc464447f 100644 > --- a/documentation/ref-manual/release-process.rst > +++ b/documentation/ref-manual/release-process.rst > @@ -97,6 +97,21 @@ through the same release process as do point releases. You can find more > information about stable branch maintenance at > :yocto_wiki:`/Stable_branch_maintenance`. > > +.. note:: > + > + In some circumstances, a layer can be created by the community in order to > + add a specific feature or support a new version of some package for an LTS. s/LTS/LTS release/ ? > + This is called a "mixin" layer. These are thin and specific purpose layers > + which can be stacked with an LTS release to "mix" a specific feature into > + that build. These are created on an as needed basis and maintained by the > + people who need them. > The "mixin" layers are found here : > + :yocto_git:`/meta-lts-mixins`. This makes me wonder about how official these are, though we said they are not officially supported by the project itself. Maybe we could just mention this repository in the next paragraph... > + > + Policies on testing these layers depends on how widespread their usage is s/depends/depend/ > + and determined on a case by case basis. Note that there may be other "mixin" > + layers within the wider community too. What about replacing the last sentence by "You can find "mixin" layers released in the :yocto_git:`meta-lts-mixins </meta-lts-mixins>` repository, but other such layers may be released elsewhere by the wider community." ? Thanks again for this patch. Once this one is merged, we need another pass on the page, as there are obsolete and missing details. LTS releases are not mentioned yet, and other releases are not supported for one year any more. I also saw some links that should be updated. Thanks again Cheers Michael.
On Wed, 1 Mar 2023 at 10:44, Michael Opdenacker via lists.yoctoproject.org <michael.opdenacker=bootlin.com@lists.yoctoproject.org> wrote: > This makes me wonder about how official these are, though we said they > are not officially supported by the project itself. Maybe we could just > mention this repository in the next paragraph... They are not official. Official things get tested on the AB and breakage blocks the changes; these layers are ad hoc, as is. Alex
On 01.03.23 at 10:49, Alexander Kanavin wrote: > On Wed, 1 Mar 2023 at 10:44, Michael Opdenacker via > lists.yoctoproject.org > <michael.opdenacker=bootlin.com@lists.yoctoproject.org> wrote: >> This makes me wonder about how official these are, though we said they >> are not officially supported by the project itself. Maybe we could just >> mention this repository in the next paragraph... > They are not official. Official things get tested on the AB and > breakage blocks the changes; these layers are ad hoc, as is. Right, but it was the wording that was giving me this impression. Thanks! Michael.
On Wed, 2023-03-01 at 10:52 +0100, Michael Opdenacker via lists.yoctoproject.org wrote: > On 01.03.23 at 10:49, Alexander Kanavin wrote: > > On Wed, 1 Mar 2023 at 10:44, Michael Opdenacker via > > lists.yoctoproject.org > > <michael.opdenacker=bootlin.com@lists.yoctoproject.org> wrote: > > > This makes me wonder about how official these are, though we said they > > > are not officially supported by the project itself. Maybe we could just > > > mention this repository in the next paragraph... > > They are not official. Official things get tested on the AB and > > breakage blocks the changes; these layers are ad hoc, as is. > > > Right, but it was the wording that was giving me this impression. I think we need to make it clear that we've gone as far as hosting things to give a common place for people to look/share but we don't currently offer any testing. Cheers, Richard
Hi all, Thanks for the reviews. On 3/1/23 10:44, Michael Opdenacker wrote: > Hi Yoann > > Many thanks for the patch! > > On 28.02.23 at 23:13, Yoann Congal wrote: >> This is heavily inspired from: >> https://wiki.yoctoproject.org/wiki/index.php?title=Stable_Release_and_LTS&oldid=84847#LTS_.E2.80.9CMixin.E2.80.9D_repositories >> >> Signed-off-by: Yoann Congal <yoann.congal@smile.fr> >> --- >> documentation/ref-manual/release-process.rst | 15 +++++++++++++++ >> 1 file changed, 15 insertions(+) >> >> diff --git a/documentation/ref-manual/release-process.rst b/documentation/ref-manual/release-process.rst >> index 19e804063..cc464447f 100644 >> --- a/documentation/ref-manual/release-process.rst >> +++ b/documentation/ref-manual/release-process.rst >> @@ -97,6 +97,21 @@ through the same release process as do point releases. You can find more >> information about stable branch maintenance at >> :yocto_wiki:`/Stable_branch_maintenance`. >> +.. note:: >> + >> + In some circumstances, a layer can be created by the community in order to >> + add a specific feature or support a new version of some package for an LTS. > > > s/LTS/LTS release/ ? I will apply this for v2. > >> + This is called a "mixin" layer. These are thin and specific purpose layers >> + which can be stacked with an LTS release to "mix" a specific feature into >> + that build. These are created on an as needed basis and maintained by the >> + people who need them. > >> The "mixin" layers are found here : >> + :yocto_git:`/meta-lts-mixins`. > > > This makes me wonder about how official these are, though we said they are not officially supported by the project itself. Maybe we could just mention this repository in the next paragraph... > >> + >> + Policies on testing these layers depends on how widespread their usage is > > > s/depends/depend/ I will apply this for v2. >> + and determined on a case by case basis. Note that there may be other "mixin" >> + layers within the wider community too. > > > What about replacing the last sentence by > > "You can find "mixin" layers released in the :yocto_git:`meta-lts-mixins </meta-lts-mixins>` repository, but other such layers may be released elsewhere by the wider community.> ? This is better, I will apply this for v2. > > Thanks again for this patch. > Once this one is merged, we need another pass on the page, as there are obsolete and missing details. LTS releases are not mentioned yet, and other releases are not supported for one year any more. I also saw some links that should be updated. Agreed, On 3/1/23 10:54, Richard Purdie wrote: > On Wed, 2023-03-01 at 10:52 +0100, Michael Opdenacker via lists.yoctoproject.org wrote: >> On 01.03.23 at 10:49, Alexander Kanavin wrote: >>> On Wed, 1 Mar 2023 at 10:44, Michael Opdenacker via lists.yoctoproject.org <michael.opdenacker=bootlin.com@lists.yoctoproject.org> wrote: >>>> This makes me wonder about how official these are, though we said they >>>> are not officially supported by the project itself. Maybe we could just >>>> mention this repository in the next paragraph... >>> They are not official. Official things get tested on the AB and >>> breakage blocks the changes; these layers are ad hoc, as is. >> >> Right, but it was the wording that was giving me this impression. > I think we need to make it clear that we've gone as far as hosting > things to give a common place for people to look/share but we don't > currently offer any testing. I'll make it clearer in v2. Thanks! Regards,
diff --git a/documentation/ref-manual/release-process.rst b/documentation/ref-manual/release-process.rst index 19e804063..cc464447f 100644 --- a/documentation/ref-manual/release-process.rst +++ b/documentation/ref-manual/release-process.rst @@ -97,6 +97,21 @@ through the same release process as do point releases. You can find more information about stable branch maintenance at :yocto_wiki:`/Stable_branch_maintenance`. +.. note:: + + In some circumstances, a layer can be created by the community in order to + add a specific feature or support a new version of some package for an LTS. + This is called a "mixin" layer. These are thin and specific purpose layers + which can be stacked with an LTS release to "mix" a specific feature into + that build. These are created on an as needed basis and maintained by the + people who need them. The "mixin" layers are found here : + :yocto_git:`/meta-lts-mixins`. + + Policies on testing these layers depends on how widespread their usage is + and determined on a case by case basis. Note that there may be other "mixin" + layers within the wider community too. + + Testing and Quality Assurance =============================
This is heavily inspired from: https://wiki.yoctoproject.org/wiki/index.php?title=Stable_Release_and_LTS&oldid=84847#LTS_.E2.80.9CMixin.E2.80.9D_repositories Signed-off-by: Yoann Congal <yoann.congal@smile.fr> --- documentation/ref-manual/release-process.rst | 15 +++++++++++++++ 1 file changed, 15 insertions(+)