Re: [xwiki-devs] [Brainstormoing] Removing old "since" from xwiki.org

Yes but we have to decide between: * Make it simpler and nicer for new users coming in and on versions that xwiki.org supports * Make is less nice for new users but nicer for old users using not supported versions of XWiki So far we’ve decided to not keeping the documentation for old versions of XWiki, see https://www.xwiki.org/xwiki/bin/view/Main/Support#HSupportedVersions which says "You won't find documentation for old versions on this web site”. Me neither and I don’t think there’s a magical solution :) Note that now that we’ve removed the platform and enterprise wikis and moved the main doc under https://www.xwiki.org/xwiki/bin/view/Documentation/ it’s slightly easier to copy the documentation: we would need to copy this space when we do a release. Note that e.x.o would need to be handled too. But that’s just the technical aspect. In practice it’s a LOT of work to handle several versions as ElasticSearch is doing: https://www.elastic.co/guide/index.html The work I can imagine: * Whenever adding something new, need to decide in which doc version it goes. And right now we don’t have merge support in XWiki so it would need to be by hand * When we do refactorings (so on the latest doc), and we need to merge to LTS or Stable we need to find the old place where it was In any case it would take substantial more time to handle multiple versions (not even mentioning multiple languages ;)). And I don’t think we have a large enough participating community to allow for this…. <aside> If you remember Caty, at some point, we discussed about implementing an app for doing this. In short it would be similar to the Release Notes app where you can add a new release change item (here it would be a new Doc item) and when you do so, you also enter info in the xproperty corresponding to the versions that apply to the doc item. Ofc you also enter the Category/Subcategories (or tags), etc. Then you can browse a Categories/Tags, say “Installation” and “MySQL” and an XWik version (defaults to latest) and you’ll have a nice LT with all the doc items corresponding to that. Ofc there are problems with this, for ex: * coherent doc * you must have one item doc per heading (to be fined-grained enough, works less well for tutorials types of documents) </aside> Thanks -Vincent