[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