From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from aws-us-west-2-korg-lkml-1.web.codeaurora.org (localhost.localdomain [127.0.0.1]) by smtp.lore.kernel.org (Postfix) with ESMTP id 81B1CC433F5 for ; Wed, 8 Dec 2021 22:08:32 +0000 (UTC) Received: from mail-ed1-f43.google.com (mail-ed1-f43.google.com [209.85.208.43]) by mx.groups.io with SMTP id smtpd.web09.3230.1639001311142524160 for ; Wed, 08 Dec 2021 14:08:31 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@linaro.org header.s=google header.b=d8uyJ/EM; spf=pass (domain: linaro.org, ip: 209.85.208.43, mailfrom: nicolas.dechesne@linaro.org) Received: by mail-ed1-f43.google.com with SMTP id r11so12943077edd.9 for ; Wed, 08 Dec 2021 14:08:30 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=1aqLGn9ZQxBf1z5rYNrGj34kzBjlfbRmglUFHoRGdDY=; b=d8uyJ/EMtnoQ38jteUX48iY3EA4rU82aEkwiPdRWomBUY/eQP15YQSli4KUh8a8P00 I1tPjGI4hUBIywYHh5N2ii8QgXAst7vo/asg1AIQOmu36w8ee/Vphl0XDHFlVxY8cPB4 StpOaMyrievxOmacpg1U5F6LTd2BG/gw0pumKi1nOirHllxVO0KNiiGonEu8HFsXTRZu f00S16gEUcfWYXR+DlbX53AYm9mu2iVBVlxh8mRKUtMA52ru/Y4St2q/ZsgWzS661d6n yqCXlXuKV3leAAPYkBoh1cy83Umja1PRLWDIPwIVduFJToma+oA0V17V+RQ+XB4hbpzp 8Jxg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=1aqLGn9ZQxBf1z5rYNrGj34kzBjlfbRmglUFHoRGdDY=; b=lXL++DuXR8i9zNhMGuRO5qJyO2y2Es7bd5sbkxfDnBWwwpfIFHQx/PjCq5ETBduIJ0 FIdH/7vrzT0YFhSfqh+2HnvH8yjk3FLdZe2rwM0/BMzWleQGAPTCo8SCrQDzOnRgtNgV bybHvWX9bo46/yE5I8D5OYDQgvmxhmcJQgMGdHlov0QQe7yk/8CM4FGpk5IxcmeqPUIW JjsWzbpsXJONgap4eq40/fbkgZHoRumJh4dK9726MJZlOesLqcWk/CfeJoe+yW5Qss9K w1lrBODhG141Tojrm6v6hsLmJGaPahCkLVg5kT3i16wTS3BEUoeeWgPfHAXKBBS7HyCf RqVA== X-Gm-Message-State: AOAM531uafBviw3skHsIW/NaDBQoDvDghJNd2NtyiAiT2+0tNs5dk+3h dRkUw3DFCNUeTToRlgO0p/2X2awv2Lh2/RDv3THJpQ== X-Google-Smtp-Source: ABdhPJz7pkoJeHs/OCLoPsyVMRqf8MVCkRV7IqAAH7lPj5OKNGPki3zb/6dPhTZ0pbkv5GNcWdbahM41RAwXhZRx78o= X-Received: by 2002:a17:907:7f8b:: with SMTP id qk11mr9919219ejc.204.1639001309340; Wed, 08 Dec 2021 14:08:29 -0800 (PST) MIME-Version: 1.0 References: <20211201135949.193842-1-michael.opdenacker@bootlin.com> <20211203093452.sk3e6ksnwmsbnjn2@fedora> <20211203100259.54n7h7ghlqfr5tia@fedora> <20211203105151.3hez2atqxq3ye63h@fedora> <56b2a1f4-9a8e-11a7-1ced-b9cbba5eda53@bootlin.com> In-Reply-To: <56b2a1f4-9a8e-11a7-1ced-b9cbba5eda53@bootlin.com> From: Nicolas Dechesne Date: Wed, 8 Dec 2021 23:08:18 +0100 Message-ID: Subject: Re: [docs] [PATCH yocto-autobuilder-helper] scripts/run-docs-build: stop using the "transition" branch To: Michael Opdenacker Cc: Quentin Schulz , yocto@lists.yoctoproject.org, docs@lists.yoctoproject.org Content-Type: multipart/alternative; boundary="000000000000d47a1805d2a9ba6c" List-Id: X-Webhook-Received: from li982-79.members.linode.com [45.33.32.79] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 08 Dec 2021 22:08:32 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/yocto/message/55525 --000000000000d47a1805d2a9ba6c Content-Type: text/plain; charset="UTF-8" On Wed, Dec 8, 2021 at 10:57 PM Michael Opdenacker < michael.opdenacker@bootlin.com> wrote: > Quentin, Nico, > > On 12/3/21 11:51 AM, Quentin Schulz wrote: > > > > I think all our issues always come down to this weird and inefficient > > organization we have for docs and common files between doc releases. > > We'll need to settle on something one day because I don't think what > > we're doing today is working :/ > > > Thanks for your reviews. Good to know that the "transition" branch is > still in use in spite of what I wrongly believed. > It indeed, it's a good idea to see what other projects are doing. Maybe > what we are doing is unnecessarily complicated. > > Look at Python docs (https://docs.python.org/) for example. They have a > switcher as we do, and also a left bar the latest versions and a > separate page for all versions. However, such versions are only shown on > the top page. When you enter one of the documents though for a given > version, the left bar is used for navigation between sections instead, > and you no longer have references to other versions. > docs.pythong.org is where we stole the idea of the switcher ;-) Would anyone be able to figure out if their 'publishing' script is available anywhere? if we could mimic that somehow that might be good. > > Let's keep thinking about this, to find an easier to manage solution. > Thanks again > Michael. > > -- > Michael Opdenacker, Bootlin > Embedded Linux and Kernel engineering > https://bootlin.com > > --000000000000d47a1805d2a9ba6c Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable


=
On Wed, Dec 8, 2021 at 10:57 PM Micha= el Opdenacker <michael= .opdenacker@bootlin.com> wrote:
Quentin, Nico,

On 12/3/21 11:51 AM, Quentin Schulz wrote:
>
> I think all our issues always come down to this weird and inefficient<= br> > organization we have for docs and common files between doc releases. > We'll need to settle on something one day because I don't thin= k what
> we're doing today is working :/


Thanks for your reviews. Good to know that the "transition" branc= h is
still in use in spite of what I wrongly believed.
It indeed, it's a good idea to see what other projects are doing. Maybe=
what we are doing is unnecessarily complicated.

Look at Python docs (https://docs.python.org/) for example. They have a<= br> switcher as we do, and also a left bar the latest versions and a
separate page for all versions. However, such versions are only shown on the top page. When you enter one of the documents though for a given
version, the left bar is used for navigation between sections instead,
and you no longer have references to other versions.
<= br>
docs.pythong.org is w= here we stole the idea of the switcher ;-)=C2=A0
Would anyone be = able to figure out if their 'publishing' script is available anywhe= re? if we could mimic that somehow that might be good.=C2=A0
=C2= =A0

Let's keep thinking about this, to find an easier to manage solution. Thanks again
Michael.

--
Michael Opdenacker, Bootlin
Embedded Linux and Kernel engineering
https:= //bootlin.com

--000000000000d47a1805d2a9ba6c--