On 4/11/16, 12:54 AM, "Gerard Braad" <m...@gbraad.nl> wrote:
>Hi Steven, > >On Mon, Apr 11, 2016 at 3:37 PM, Steven Dake (stdake) <std...@cisco.com> >wrote: >> However, when new >> contributors see the nitpicking going on in reviews, I think they may >>get >> 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 >stability. Gerard, 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 well. 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. Regards, -steve > >regards, > > >Gerard > >-- >Gerard Braad — 吉拉德 > F/OSS & IT Consultant in Beijing > http://gbraad.nl gpg: 0x592CFE7 > >__________________________________________________________________________ >OpenStack Development Mailing List (not for usage questions) >Unsubscribe: openstack-dev-requ...@lists.openstack.org?subject:unsubscribe >http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev __________________________________________________________________________ OpenStack Development Mailing List (not for usage questions) Unsubscribe: openstack-dev-requ...@lists.openstack.org?subject:unsubscribe http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
