[openstack-dev] [docs][release][ptl] Adding docs to the release schedule

Brian Rosmaita rosmaita.fossdev at gmail.com
Thu Mar 2 22:53:30 UTC 2017


On 3/2/17 9:45 AM, Ian Cordasco wrote:
> -----Original Message-----
> From: Telles Nobrega <tenobreg at redhat.com>
> Reply: OpenStack Development Mailing List (not for usage questions)
> <openstack-dev at lists.openstack.org>
> Date: March 2, 2017 at 08:01:29
> To: OpenStack Development Mailing List (not for usage questions)
> <openstack-dev at lists.openstack.org>
> Cc: openstack-docs at lists.openstack.org <openstack-docs at lists.openstack.org>
> Subject:  Re: [openstack-dev] [docs][release][ptl] Adding docs to the
> release schedule
> 
>> I really believe that this idea will makes us work harder on keeping our
>> docs in place and will make it for a better documented producted by release
>> date.
>> As shared before, I do believe that this is isn't easy and will demand a
>> lot of effort from some teams, specially smaller teams with too much to do,
>> but we from Sahara are on board with this approach and will try our best to
>> do so.
> 
> Most things worth doing are difficult. =) This seems to be one of
> them. If deliverable teams really work together, they may end up in a
> situation like Glance did this cycle where we kind of just sat on our
> hands after RC-1 was tagged. That time *could* have been better spent
> reviewing all of our documentation.

At the risk of sounding defensive here, what exactly are you referring
to?  The api-ref [0], the dev docs in the glance repo [1], and the api
docs in the glance-specs repo [2] all had patches up for review after RC-1.

[0] https://review.openstack.org/#/c/426603/
[1] https://review.openstack.org/#/c/429341/
[2] https://review.openstack.org/#/c/426605/

> I know projects go sideways all the time. I think this was Glance's
> first cycle like this in a few cycles. But if we can make a habit of
> creating excellent release candidates, we can spend the intermediate
> time on documentation. I think that's a good compromise.
> 
> --
> Ian Cordasco
> 
> __________________________________________________________________________
> OpenStack Development Mailing List (not for usage questions)
> Unsubscribe: OpenStack-dev-request at lists.openstack.org?subject:unsubscribe
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
> 




More information about the OpenStack-dev mailing list