Please note that the original goal here was not to discuss what we would do if we were a large project with lots of developers, who liked to write documentation, etc :)
The goal was: 1) to answer the feedback we got from a reader saying that we have too many distractions when reading xwiki wiki pages and that they break the visual flow and make the pages harder to read, all this in an offer to bring in more users and increase the active installs. 2) to implement what we decided a long time ago, ie. support only 3 branches, see https://www.xwiki.org/xwiki/bin/view/Main/Support#HSupportedVersions One relatively simple alternative if we really don’t want to remove some information could be: * Implement a {{backwardCompatibilityMacro/}} wiki macro on xwiki.org that you would use to put information about previous versions of XWiki * When viewing it, it would be folded by default with some small clickable indicator/icon in the gutter (or somewhere else), which, when clicked, would make it visible. Another option would be a “show backward compat info” toggle somewhere in the page UI. I still prefer a lot to remove old stuff and to continue our strategy of only supporting 3 branches and to push users to upgrades to those 3 branches because that’s one way of participating to the XWiki open source project as it makes users test those versions and upgrade. Thanks -Vincent > On 18 Jun 2018, at 13:19, Vincent Massol <[email protected]> wrote: > > Hi, > > I think we need to start removing old mentions on xwiki.org. It makes it > harder to read xwiki pages (as a user has just reported, see > https://forum.xwiki.org/t/how-to-increase-active-installs-of-xwiki/3132/6?u=vmassol). > > > Also we said we don't support documenting old stuff (we only support doc for > LTS, stable and latest). > > For example I just did this: > http://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/Installation/InstallationConcludingSteps/?viewer=changes&rev1=11.2&rev2=11.3 > > > Is that ok with everyone? > > Thanks > -Vincent >
