[U-Boot] [PATCH 00/50] doc: Shape into useful HTML docs

Bin Meng bmeng.cn at gmail.com
Wed Jul 24 04:59:24 UTC 2019


Hi Tom,

On Tue, Jul 23, 2019 at 11:29 PM Tom Rini <trini at konsulko.com> wrote:
>
> On Tue, Jul 23, 2019 at 05:00:52PM +0200, Wolfgang Denk wrote:
> > Dear Bin,
> >
> > In message <CAEUhbmVBz0z+Dh_q1hJKDOuoiJ1ZJ025hiLrYFUwDbp0UrxD1g at mail.gmail.com> you wrote:
> > >
> > > > @Wolfgang, is it possible to host the Sphinx HTML docs on denx.de?
> > > >
> > > > This series is available at u-boot-x86/doc for testing.
> > > >
> > >
> > > Ping?
> >
> > Yes, this is possible.  Where can I find the HTML files?  And where
> > would you want to put them?  And what is the planned update
> > strategy?
> >
> > I mean, plain HTML documents are a bit lame, as they refer to a
> > specific version of U-Boot only.  What if I want to see the docs for
> > a version of half a year ago?
>
> Thinking out loud, how about .../<VERSION>/ and we re-generate the docs
> for each full release?

If I understand correctly, you were proposing exact the same thing as
I thought, so something like:

http://denx.de/u-boot/doc/html/v2018.07/
http://denx.de/u-boot/doc/html/v2019.10-rc1/
http://denx.de/u-boot/doc/html/latest/

Anyway these are doc update strategy and has nothing to do with the
patch series itself. If no issues, could you please apply them?
I am afraid the longer time it sits in the patch queue, the
possibility of merge conflicts happen.

Regards,
Bin


More information about the U-Boot mailing list