[Gluster-devel] Documentation expectations for 3.5 release

[Joe Julian]

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 <vbellur at redhat.com> 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
>Gluster-devel at nongnu.org
>https://lists.nongnu.org/mailman/listinfo/gluster-devel

-- 
Sent from my Android device with K-9 Mail. Please excuse my brevity.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://supercolony.gluster.org/pipermail/gluster-devel/attachments/20140415/58da5ea8/attachment-0001.html>