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 0262BC4332F for ; Wed, 8 Dec 2021 22:20:19 +0000 (UTC) Received: from mail-io1-f46.google.com (mail-io1-f46.google.com [209.85.166.46]) by mx.groups.io with SMTP id smtpd.web08.3311.1639002018103893063 for ; Wed, 08 Dec 2021 14:20:18 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@gmail.com header.s=20210112 header.b=ZjIdqJzO; spf=pass (domain: gmail.com, ip: 209.85.166.46, mailfrom: ticotimo@gmail.com) Received: by mail-io1-f46.google.com with SMTP id z26so4475947iod.10; Wed, 08 Dec 2021 14:20:18 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=jVfrCBvLcnJ65PQzpu4Mf3l074sgF1HZTWV1QT2Na/Q=; b=ZjIdqJzOLkn80FGti2KuJrMHOK6VguKezbLrC9zlM9gKfi/+ZVuFmU9rS8VRKy1mH1 EnF10hqg7yeNOiJjKMVwF0ch0BrbN4XOHqyzBeXGMUmxCcvxYiNLfysPrr2q40notBoB Xek2yezdbu9HDxhW7KuihkXbqXclweNEGnixh8BWL5TVWq0unu8CC7OF3iBziaAPo5/v FUgpbHG9FRHnIGzzZQNVGo+e1781VAWvvR/v6LFQXwmm9SgXpeY1wZU+X+1nF/SxPjNf 9YVRcWwTrNjXNqfFUNGKP3MtIQ2C1nKF6ttws2j5ivszFksf1AAJm1wEm+aZl+5zTAe6 k1zQ== 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=jVfrCBvLcnJ65PQzpu4Mf3l074sgF1HZTWV1QT2Na/Q=; b=XVafHOQjvwPxqYm/l/TI8FQCNuQ2F+SS+HLGj/tB7EbjbxSHXJMeXS6aAwLL/tsjD8 E++SZ82MMLTDbaQwfUGcaUts6jFLvh4DjXW67hIqQSfM97MlLYq3CaAaGC1OkCDW+tNB tFhz9vQfawDpny4ETkTZ1d+vkz9+dOBME0+xjqaFmhN2oz8LyiX4kUQYWJ2rAN/VQdlH yicAmWOLqQuL3HxPe7NJz3txg88wybBx9qSxv3z8SBwO5AAeVZq1CqLdnl+kF+cEl40o AnzPFe+Xi21EllFi/tp9s571+pK0DS2sgzEs1tnTQghk3Qo4bIM6NpgimkHvzsy+RW3W KIzA== X-Gm-Message-State: AOAM532gqUbcd80PAEz9My4xZyh7kNeew4pgE+YdJnqlUdBbQdukdmEN 7BX5ujzz/ol559hPxYAfZqFmZ/IRsrfrFLQFfh4= X-Google-Smtp-Source: ABdhPJyV/5dzXkhCSxNXNo8/G1lAzdaMLQpA7XsD5bgeIid4QrQfK/fQsR8RjYraZsLqyPYuyp++yjlSePuh5qRCaJ0= X-Received: by 2002:a05:6638:13c5:: with SMTP id i5mr3382896jaj.88.1639002017359; Wed, 08 Dec 2021 14:20:17 -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: From: Tim Orling Date: Wed, 8 Dec 2021 14:20:06 -0800 Message-ID: Subject: Re: [docs] [PATCH yocto-autobuilder-helper] scripts/run-docs-build: stop using the "transition" branch To: Nicolas Dechesne Cc: Michael Opdenacker , Quentin Schulz , docs@lists.yoctoproject.org, yocto@lists.yoctoproject.org Content-Type: multipart/alternative; boundary="00000000000007ed6505d2a9e502" 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:20:18 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/yocto/message/55526 --00000000000007ed6505d2a9e502 Content-Type: text/plain; charset="UTF-8" On Wed, Dec 8, 2021 at 2:08 PM Nicolas Dechesne wrote: > > > 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. > Maybe? https://github.com/python/docsbuild-scripts/ Found on https://pythondev.readthedocs.io/infra.html > > >> >> 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 >> >> > -=-=-=-=-=-=-=-=-=-=-=- > Links: You receive all messages sent to this group. > View/Reply Online (#2237): > https://lists.yoctoproject.org/g/docs/message/2237 > Mute This Topic: https://lists.yoctoproject.org/mt/87428499/924729 > Group Owner: docs+owner@lists.yoctoproject.org > Unsubscribe: https://lists.yoctoproject.org/g/docs/unsub [ > ticotimo@gmail.com] > -=-=-=-=-=-=-=-=-=-=-=- > > --00000000000007ed6505d2a9e502 Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable


On Wed, Dec 8, 2021 at 2:08 PM Nicolas Dechesne <nicolas.dechesne@linaro.org>= wrote:


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<= 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.py= thong.org is where we stole the idea of the switcher ;-)=C2=A0
Would anyone be able to figure out if their 'publishing' script i= s available anywhere? if we could mimic that somehow that might be good.=C2= =A0


-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-
Links: You receive all messages sent to this group.
View/Reply Online (#2237): https://lists.yoctoproj= ect.org/g/docs/message/2237
Mute This Topic: https://lists.yoctoproject.org/mt/= 87428499/924729
Group Owner: docs+owner@lists.yoctoproject.org
Unsubscribe: https://lists.yoctoproject.org/g/docs/unsub<= /a> [ticotimo@gmail= .com]
-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-

--00000000000007ed6505d2a9e502--