What Documentation Pages Would You Like To See Updated?

[gabrielc]

Hi everyone!

I must admit that I was quite ambitious when I set out on helping with the documentation rework .

That being said, I wasn’t idle all this time. I just added some proposals to the forum, and I’m eagerly waiting for your feedback.

"Getting Started" Page Rework Proposal

Hi everyone! A while ago I started reviewing some of the documentation pages and worked a bit on the Getting Started page. I wanted to share with you my conclusions and ask for your opinions. Proposed changes: Introductory paragraph should be shorter. A version of the following could be used: “Welcome! Regardless of if you need a collaborative intranet, a knowledge base, a CMS, a Website Creation tool or an entirely different thing, XWiki’s got you covered.” The download link has low vi…

"Features" Page Rework Proposal

Hi everyone! A while ago I started reviewing some of the documentation pages and worked a bit on the Features page. I wanted to share with you my conclusions and ask for your opinions. Given that the page is located under the “User Guide” section, I believe that it should be filled with mostly user facing features and information. At the moment, the page also contains quite a bit of content geared towards administrators and developers. The admin and dev features should still be visible, as s…

Thank you everyone for your suggestions! All of them are neatly stashed in my personal notes and I will definitely look at them when thinking about how to proceed further.

While the work is still far from over (like… reaaaaaly far), and I cannot give an accurate estimate to when it will be complete, I want you to know that it is something that I am concerned with, and I’m still trying to tackle whenever I get the time to do it.