Open Stack

-----Original Message-----
From: Brian Rosmaita <rosmaita.fossdev at gmail.com>
Reply: OpenStack Development Mailing List (not for usage questions)
<openstack-dev at lists.openstack.org>
Date: March 2, 2017 at 16:55:10
To: OpenStack Development Mailing List (not for usage questions)
<openstack-dev at lists.openstack.org>
Subject:  Re: [openstack-dev] [docs][release][ptl] Adding docs to the
release schedule

> On 3/2/17 9:45 AM, Ian Cordasco wrote:
> > -----Original Message-----
> > From: Telles Nobrega
> > Reply: OpenStack Development Mailing List (not for usage questions)
> >
> > Date: March 2, 2017 at 08:01:29
> > To: OpenStack Development Mailing List (not for usage questions)
> >
> > Cc: 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'm not trying to say we did something wrong. Just that there were
quite a few people who were focusing on things other than the Ocata
documentation. Hence the emphasis on "could". I think Glance came out
of Ocata looking great. I think we could look even better if we spent
more time on improving our documentation.

--
Ian Cordasco