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

[Vijay Bellur]

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