On Tue, 23 Apr 2024, David Malcolm wrote:
> My hope is that the URL suffixes don't change: we shouldn't be adding
> new command-line options on the release branches, and I'd hope that
> texinfo doesn't change the generated anchors from run to run.

Already before this thread, but definitely now, I started to wonder 
whether we shouldn't fundamentally change our approach on online 
documentation for release branches.

My proposal is to have only one version per release branch online,
that is, not https://gcc.gnu.org/onlinedocs/gcc-14.1.0 and
https://gcc.gnu.org/onlinedocs/gcc-14.2.0 and so forth, rather just

  https://gcc.gnu.org/onlinedocs/gcc-14

There should be *very* few user visible changes such as new options or 
substantially different behaviors on release branches - pretty much by 
definition.

So why not have one version of the documentation per release branch where 
users of 14.1 get documentation fixes/improvements made for later in the
branch?

And it would vastly simplify things in terms of creating docs - simply 
build them once a day, no changes for point releases... (and much, much
less duplication).

What do you think?

Gerald

Reply via email to