From: Nicolas Dechesne <nicolas.dechesne@linaro.org>
To: Michael Opdenacker <michael.opdenacker@bootlin.com>
Cc: Quentin Schulz <quentin.schulz@theobroma-systems.com>,
yocto@lists.yoctoproject.org, docs@lists.yoctoproject.org
Subject: Re: [docs] [PATCH yocto-autobuilder-helper] scripts/run-docs-build: stop using the "transition" branch
Date: Wed, 8 Dec 2021 23:08:18 +0100 [thread overview]
Message-ID: <CAP71WjxH8CObAABCQTdQN7YYUSww+w=a1BsF5hYCzVABLgH2Sg@mail.gmail.com> (raw)
In-Reply-To: <56b2a1f4-9a8e-11a7-1ced-b9cbba5eda53@bootlin.com>
[-- Attachment #1: Type: text/plain, Size: 1496 bytes --]
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
>
>
[-- Attachment #2: Type: text/html, Size: 2326 bytes --]
next prev parent reply other threads:[~2021-12-08 22:08 UTC|newest]
Thread overview: 9+ messages / expand[flat|nested] mbox.gz Atom feed top
2021-12-01 13:59 [PATCH yocto-autobuilder-helper] scripts/run-docs-build: stop using the "transition" branch Michael Opdenacker
2021-12-03 9:34 ` [docs] " Quentin Schulz
2021-12-03 9:49 ` Nicolas Dechesne
2021-12-03 10:02 ` Quentin Schulz
2021-12-03 10:48 ` Nicolas Dechesne
2021-12-03 10:51 ` Quentin Schulz
2021-12-08 21:57 ` Michael Opdenacker
2021-12-08 22:08 ` Nicolas Dechesne [this message]
2021-12-08 22:20 ` Tim Orling
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to='CAP71WjxH8CObAABCQTdQN7YYUSww+w=a1BsF5hYCzVABLgH2Sg@mail.gmail.com' \
--to=nicolas.dechesne@linaro.org \
--cc=docs@lists.yoctoproject.org \
--cc=michael.opdenacker@bootlin.com \
--cc=quentin.schulz@theobroma-systems.com \
--cc=yocto@lists.yoctoproject.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.