The driver: I just thought it was pointless to serve docs for older versions. That’s all
On Sat, May 7, 2022 at 12:46 AM Michael André Pearce <michael.andre.pea...@me.com.invalid> wrote: > What harm is there in keeping old docs? I’m a little -1 removal of old > docs unless there’s areal pressing driver that cannot be addressed / > resolved. > > E.g. what is the driver here? > > Space on the http server? I’d be a bit surprised if it was due to this > docs aren’t that huge, and in this day and age even my mobile probably can > store all historical docs fine…. > > If it’s build time of website, can old docs not be generated once and > marked to not rebuild for website rebuild by default, probably want to have > a flag to force a rebuild if really needed… > > > > > Sent from my iPad > > > On 6 May 2022, at 14:12, Robbie Gemmell <robbie.gemm...@gmail.com> > wrote: > > > > I think that can have its own issues in terms of most easily (for us > > and them) directing folks to the appropriate bit of doc when answering > > a question, given how often users love to ask questions about > > not-latest versions. I've found maintaining a window of docs to be a > > good balance. > > > > E.g consider that you just change the default of some values; having > > only the current docs will likely mislead other people on the > > behaviour. Sometimes even those that wrote it, because they forgot, > > and are looking at the doc to find out what it does :) > > > >> On Fri, 6 May 2022 at 13:26, Clebert Suconic <clebert.suco...@gmail.com> > wrote: > >> > >> I would prefer only keeping the current doc... older docs are part of > >> the zip bundle anyways, right? > >> > >>> On Fri, May 6, 2022 at 7:02 AM Robbie Gemmell < > robbie.gemm...@gmail.com> wrote: > >>> > >>> I think it is reasonable to remove older docs, both to control the > >>> size of the site content and since people should be using the more > >>> recent things already. > >>> > >>> For Qpid the main docs page links to the current docs, and links to > >>> the 'past releases' page where each release page then has that > >>> versions docs. We typically keep the last 2-3 years of the release > >>> specific pages/download links/docs etc available on the site. > >>> Infrequently we then trim the oldest ones out to get back nearer the 2 > >>> years. Rinse and repeat. Link to the archive for anything not on the > >>> site. > >>> > >>> On Fri, 6 May 2022 at 02:51, Clebert Suconic < > clebert.suco...@gmail.com> wrote: > >>>> > >>>> Can we stop storing old releases documentation on the website? > >>>> > >>>> > >>>> If we start to release bi weekly as we proposed, it's going to be a > >>>> lot of old releases in there. > >>>> > >>>> Over the years this has accumulated a few already > >>>> > >>>> > >>>> https://activemq.apache.org/components/artemis/documentation/ > >>>> > >>>> > >>>> > >>>> If users want a previous doc, they can always just download the older > >>>> version with the docs anyway. > >>>> > >>>> > >>>> > >>>> -- > >>>> Clebert Suconic > >> > >> > >> > >> -- > >> Clebert Suconic > -- Clebert Suconic
