Thanks for the initiative Amye!
--
On Thu, Apr 13, 2017 at 11:36 PM, Amye Scavarda <amye@xxxxxxxxxx> wrote:
+1
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-devel mailing list Gluster-devel@xxxxxxxxxxx http://lists.gluster.org/mailman/listinfo/gluster-devel