[Gluster-users] Fwd: Revamping the GlusterFS Documentation...

[Shravan Chandrashekar]

Looks like it was dropped from gluster-users list. Forwarding exclusively.

----- Forwarded Message -----
From: "Shravan Chandrashekar" <schandra at redhat.com>
To: gluster-users at gluster.org, gluster-devel at gluster.org
Cc: "Satish Mohan" <smohan at redhat.com>, spot at redhat.com, "Anjana Suparna Sriram" <asriram at redhat.com>
Sent: Monday, March 23, 2015 12:31:15 PM
Subject: Revamping the GlusterFS Documentation...

Hi All, 

"The Gluster Filesystem documentation is not user friendly and fragmented" and this has been the feedback we have been receiving. 

We got back to our drawing board and blueprints and realized that the content was scattered at various places. These include: 

[Static HTML] http://www.gluster.org/documentation/ 
[Mediawiki] http://www.gluster.org/community/documentation/ 
[In-source] https://github.com/gluster/glusterfs/tree/master/doc 
[Markdown] https://github.com/GlusterFS/Notes 

and so on… 

Hence, we started by curating content from various sources including gluster.org static HTML documentation, glusterfs github repository, 
various blog posts and the Community wiki. We also felt the need to improve the community member's experience with Gluster documentation. This led us to put some thought into the user interface. As a result we came up with a page which links all content into a single landing page: 

http://www.gluster.org/community/documentation/index.php/Staged_Docs 

This is just our first step to improve our community docs and enhance the community contribution towards documentation. I would like to thank Humble Chirammal and Anjana Sriram for the suggestions and directions during the entire process. I am sure there is lot of scope for improvement. 
Hence, request you all to review the content and provide your suggestions. 

Regards, 
Shravan Chandra