18 Jun
2018
18 Jun
'18
3:06 p.m.
If we were to export PDFs of documentation at a certain version than I
would agree with this.
Currently my feeling is that we are deleting information and not all our
users are on LTS or recent versions.
I agree is important to have the most simple and clear documentation, yet
it's bad that we don't provide versioned documentation.
Also, even cleaning now, it's a task that is very big and the info will get
deprecated in a year. If the language we use is using present tense, users
will still be confused 1 year later and still would not know about what
version that documentation is talking about. Especially since there is no
way we could validate documentation on year release.
I don't have a clear solution for this problem.
Thanks,
Caty
On Mon, Jun 18, 2018 at 3:44 PM, Thomas Mortagne <thomas.mortagne(a)xwiki.com>
wrote:
Sure, make sense.
I guess most document useless in >=LTS should be removed. Unless the
documentation is designed to give the version information of for
changelog stuff.
On Mon, Jun 18, 2018 at 1:19 PM, 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=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
--
Thomas Mortagne