Re: [docs] [PATCH 0/5 v2] Proposed docs version changes

[Michael Halstead <mhalstead@linuxfoundation.org>]

[-- Attachment #1: Type: text/plain, Size: 3333 bytes --]

These tags are in place. I back-dated them to the release day but I put
them in my name since I've added these without a release engineer involved.



On Tue, Mar 22, 2022 at 8:00 AM Richard Purdie <
richard.purdie@linuxfoundation.org> wrote:

> On Tue, 2022-03-22 at 14:54 +0000, Richard Purdie via
> lists.yoctoproject.org
> wrote:
> > On Tue, 2022-03-22 at 15:33 +0100, Quentin Schulz wrote:
> > > On 3/22/22 15:25, Richard Purdie wrote:
> > > > On Tue, 2022-03-22 at 14:58 +0100, Quentin Schulz wrote:
> > > > > Hi all,
> > > > >
> > > > > On 3/21/22 23:06, Richard Purdie wrote:
> > > > > > On Mon, 2022-03-21 at 22:56 +0100, Nicolas Dechesne wrote:
> > > > > > >
> > > > > > > Would it make sense to implement what you have in
> set_versions.py directly in
> > > > > > > Sphinx 'native' code ? e.g. directly in conf.py, or in a
> module loaded from
> > > > > > > conf.py (see how kernel does it at [1]) or yocto-vars
> extension, or as its own
> > > > > > > Sphinx extension?
> > > > > > >
> > > > > > > poky.yaml only purpose is to be loaded by yocto-vars.py which
> is a local
> > > > > > > Sphinx extension we created.
> > > > > >   > Possibly, yes. I've done it like this as it was easier to
> validate it
> > > > > was doing
> > > > > > the right things and also easier to apply in retrospect to
> previous docs
> > > > > > releases. What we want to do going forward is an open question
> and it does feel
> > > > > > like that script would be better off as a module that at least
> for master, the
> > > > > > docs code called into.
> > > > > >
> > > > > > I think that would make most sense as a follow on to this series
> if/as/when
> > > > > > people have the time to work on it and test it accordingly. As
> it stands the
> > > > > > series was already quite painful to develop (I got hooked on
> Friday and had to
> > > > > > fix it on Saturday whilst I still had the pieces all in cache).
> > > > > >
> > > > >
> > > > > Agreed. I don't think this patch series makes the doc building
> situation
> > > > > worse than it currently is so there's no reason to hold it off.
> Makes it
> > > > > even easier on stable release maintainers so it's good :)
> > > > >
> > > > > I just would like the behavior to be unchanged wrt versions listed
> in
> > > > > the switchers.js, the rest is fine and can be modified later on.
> > > >
> > > > Just to be clear, you mean adding gatesgarth and zeus back?
> > >
> > > Keeping the current behavior which is the latest dot version of all
> > > releases up to Warrior.
> > >
> > > dev
> > > 3.4.2
> > > 3.3.5
> > > 3.2.4
> > > 3.1.14
> > > 3.0.4
> > > 2.7.4
> > >
> > > is what I currently have.
> >
> > Sadly I can't make this work easily since there are no tags for 2.7.2,
> 2.7.3
> > ,2.7.4, 3.0.2, 3.0.3 or 3.0.4. There are a bunch of older releases
> missing
> > too :(
>
> Michael(H), would you be able to add some tags:
>
> yocto-2.7.4 3fd1432890f04fd659952c0f20f5750fb8c3a909
> yocto-2.7.3 a06e6bdf1d8f133dfaf6dad9c49be24f688799c4
> yocto-2.7.2 ee29f61b92c5ca7dd56393cef5fcd3ff3fe243aa
> yocto-3.0.2 ac75b463b23ae6258c1e6f3bbdefc398f3a03d43
> yocto-3.0.3 9d522e747d2715aa0b2fe4c81cacc34bfad3e1a3
> yocto-3.0.4 9f51be3a11b7422aba3617a90a98336c3c75f71e
>
> please?
>
> Cheers,
>
> Richard
>
>

-- 
Michael Halstead
Linux Foundation / Yocto Project
Systems Operations Engineer

[-- Attachment #2: Type: text/html, Size: 4666 bytes --]