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
<vincent(a)massol.net> 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…).
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/I…
Is that ok with everyone?
Thanks
-Vincent