Re: [gluster-devel][gluster-users] Usability Initiative for Gluster: Documentation

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Thanks for the initiative Amye!

On Thu, Apr 13, 2017 at 11:36 PM, Amye Scavarda <amye@xxxxxxxxxx> wrote:
One of the things that we're taking on for Gluster as a project is improving our usability overall - user experience, developer experience, contributor experience. We want Gluster to be fun to work with. 

As part of this, we'll be working on improving our overall documentation. Improving documentation is one of our big focuses as a project as we move into being more friendly to containers overall, through improving the table of contents, the style guide for how we're communicating with our users and outlining a better template structure for contribution. Finally, we'll be looking to match the look and feel of our new website as well. 


+1
 
How is this happening? 
We'll be creating another branch to make these changes without changing our current documentation. However, we're going to need your help - as you're creating documentation now, please check with either myself, Amar or Nithya so that we can keep release notes running in tandem for the new changes happening in the new structure, and what needs to be moved over from the current structure. We'll be manually diffing these as we work on going live with the new structure. 

This is of vital importance for us as a project and it's something we've been looking at for a long time. Our timelines for this are the next month to six weeks, and we'll be in a better place with our documentation to improve from here. 

Documentation improvements should reduce *lot* of load on few members here who have to respond to similar questions over and over. Also many times I heard that our flow of documentation is not great, hence took more time to get to the documentation. Hope to see them fixed.

Thanks,
Amar
 
Thanks!
- amye 

--
Amye Scavarda | amye@xxxxxxxxxx | Gluster Community Lead

_______________________________________________
Gluster-users mailing list
Gluster-users@xxxxxxxxxxx
http://lists.gluster.org/mailman/listinfo/gluster-users



--
Amar Tumballi (amarts)
_______________________________________________
Gluster-users mailing list
Gluster-users@xxxxxxxxxxx
http://lists.gluster.org/mailman/listinfo/gluster-users

[Index of Archives]     [Gluster Development]     [Linux Filesytems Development]     [Linux ARM Kernel]     [Linux ARM]     [Linux Omap]     [Fedora ARM]     [IETF Annouce]     [Bugtraq]     [Linux OMAP]     [Linux MIPS]     [eCos]     [Asterisk Internet PBX]     [Linux API]

  Powered by Linux