Yep, every single time I google sth artemis related I end up in the old docs.
On Mon, May 9, 2022 at 6:54 PM Justin Bertram <jbert...@apache.org> wrote: > One reason to remove old docs is that folks who don't know better > invariably read old docs rather than the latest and greatest. This is > usually caused by search engines handing out old links. > > I'm +1 to remove them. > > > Justin > > On Fri, May 6, 2022 at 11:53 PM 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 > > > > >
