[openstack-dev] [kolla][vote] Nit-picking documentation changes

Steven Dake (stdake) stdake at cisco.com
Mon Apr 11 08:20:33 UTC 2016

On 4/11/16, 12:54 AM, "Gerard Braad" <me at gbraad.nl> wrote:

>Hi Steven,
>On Mon, Apr 11, 2016 at 3:37 PM, Steven Dake (stdake) <stdake at cisco.com>
>> However, when new
>> contributors see the nitpicking going on in reviews, I think they may
>> discouraged about writing documentation for other parts of Kolla.
>This is one of the things I experienced myself and this thought had
>crossed my mind. Although, the high expectation is understandable as
>at the moment getting an environment up-and-running according to the
>quickstart guide is a hit and miss. This is of course not directly
>related to the guide itself (or is it?), but possible issues in code


I believe the QSG is in pretty good shape.  We have been suffering some
serious code churn when we moved to docker 1.10 and kolla-docker module.
These were both highly positive changes, but destabilized he code base a
bit - blocking development for nearly 2 weeks during m3 (iirc).  We have
also had a lot of code churn related to upgrade, reconfigure, and drop
root features which were again highly positive but partially disruptive as

I don't think deployment is not hit or miss as long as the QSG are
followed to a T :)

>Although, I think we need to be more clear about what needs to be in
>the Quickstart guide. Is a mult-node environment something we need to
>discuss or is this for another document? What about common issues and
>error codes that can be addressed?

I agree we need more clarity in what belongs in the QSG.  At Tokyo summit
we held a documentation session where we produced an outline of what the
documentation should be.  We didn't define scope or boundaries on the
documentation outline, nor did we define review expectations.  I am open
to anyone from the community putting together an outline with scope and
boundaries as a review in the specs directory so we can iterate on what
exactly should go where and what the code review expectations are.


>Gerard Braad — 吉拉德
>   F/OSS & IT Consultant in Beijing
>   http://gbraad.nl  gpg: 0x592CFE7
>OpenStack Development Mailing List (not for usage questions)
>Unsubscribe: OpenStack-dev-request at lists.openstack.org?subject:unsubscribe

More information about the OpenStack-dev mailing list