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
