gluster-devel
[Top][All Lists]
Advanced

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

Re: [Gluster-devel] Documentation expectations for 3.5 release


From: Joe Julian
Subject: Re: [Gluster-devel] Documentation expectations for 3.5 release
Date: Tue, 15 Apr 2014 12:33:57 -0700
User-agent: K-9 Mail for Android

My own understanding is that the block is for documentation on the new features in the 3.5 cycle, not about going back and fixing all the stuff that's been missed so far.

You just wrote this stuff. Let's make sure we know how to use it. Even if you just do it very simply and don't integrate it into the admin guide, at least get something written up. I can even help format and integrate as long as I don't have to scan source and guess.

On April 15, 2014 11:17:47 AM PDT, Vijay Bellur <address@hidden> wrote:
On 04/15/2014 10:59 AM, Justin Clift wrote:
On 15/04/2014, at 6:46 PM, Vijay Bellur wrote:
<snip>
I do not think holding 3.5.0 back for documentation backlog that has not been covered earlier is right. I certainly think that there's no one stroke of the brush that can fix all our documentation limitations. Given that we have adequate information available (in some form) for features in 3.5, I am still inclined to move these bugs as blockers for 3.5.1 and go ahead with 3.5.0 as it exists today.

Where's the pressure coming from to release 3.5.0 without basic user
documentation for all features?

There is no pressure coming from anywhere but holding back code without
doing releases is not good for _any_ community. We would definitely like
to move to a more "release early, release often" model than just sitting
on a lot of hard work that has gone in the form of developing and
testing code.

I do not agree that we lack basic user documentation. As I mentioned in
my previous mail, we do have some basic documentation available and it
will only get better by 3.5.1.


Is there _actual pressure_ from a defined source (who I can speak to), or
is it something such as "we're really overdue already", etc?


Thanks for the offer to speak but I am not really looking for that since
there is no such source :). Even with the hypothetical case of any such
source being present, I feel that I can adequately represent the
community and not let any of our interests down.

The real fact of the matter is that we have spent quite a lot of time in
beta, we have postponed our GA by several weeks and holding it back
because of inadequate documentation representation in admin guide does
seem like a stretch to me.

-Vijay



Gluster-devel mailing list
address@hidden
https://lists.nongnu.org/mailman/listinfo/gluster-devel

--
Sent from my Android device with K-9 Mail. Please excuse my brevity.
reply via email to

[Prev in Thread] Current Thread [Next in Thread]