+1 for that logic with one caveat: if we do follow a release train model, in the best case, we would cut a new `X.Y.0` release every month. And that might make the docs disappear quickly.
Example: assume we release 1.1.0 in August and do not have to do any patch release. It follows that we release 1.4.0 in November. And it means that in November, we retire the docs for 1.1.0. Although it certainly makes sense from a project perspective, it might create some annoyance for users, if the docs associated with the version they use disappear after 3 months. Granted, this is for the best possible case where we never have to cut a patch release for our monthly release. The proposed logic still makes sense. We just might want a higher number of `X.Y` combinations we keep, at least for the time being. In any case, +1 to keep only the docs of the last patch release for any visible `X.Y` version. -- Pierre On Thu, Aug 21, 2025 at 11:33 PM Dmitri Bourlatchkov <di...@apache.org> wrote: > Hi Eric, > > It's a good point, yet for the next few months the list is probably going > to be quite manageable. > > I'd like to propose this logic for docs. Suppose we have a list of versions > X.Y.Z. For every X, keep 3 most recent Ys and only the latest Z for each Y. > > As an example, after 1.1.0 is released, we'd have docs for 1.0.1 and 1.1.0. > > If we ever have too many major releases (X), we'll have to revisit this and > sunset some of them. > > How does that sound? > > Cheers, > Dmitri. > > On Thu, Aug 21, 2025 at 2:28 PM Eric Maynard <eric.w.mayn...@gmail.com> > wrote: > > > Hi all, > > > > I was looking at the site today and noticed we have a section in the docs > > for 1.0.1. On one hand, this is great to see as I'm sure we're all > excited > > about the release. On the other, I could imagine this list getting pretty > > crowded as patch releases continue to happen. I've been wondering about > the > > best way to deal with this problem in the future. > > > > Should we release the docs by major / minor release, as in having doc > pages > > for 1.0.x and 1.1.x? > > Could we group them somehow into subsections by minor release? > > Or could we maybe just hide some releases from the dropdown menu? > > Any other ideas? > > > > Cheers, > > > > Eric M. > > >
