<div dir="ltr">Top posting. So this is how most style guide conversations go.<div>1. Hi, I'd like a standard here.</div><div>2. You're an idiot.</div><div>3. Someone is wrong on the internet and here's proof.</div><div>4. Drama, drama, more drama.</div><div><br></div><div>My process experiment has failed quite impressively and managed to derail the style guidance question. Here's the thing. I don't want to argue on Gerrit either. I don't want to have our team work on a style guide as a deliverable. I'll add this discussion topic to our next video meeting. I'll set it up in a separate thread.</div><div><br></div><div>Anne</div><div><br></div><div><br></div></div><div class="gmail_extra"><br><div class="gmail_quote">On Mon, Nov 10, 2014 at 8:53 PM, Tom Fifield <span dir="ltr"><<a href="mailto:tom@openstack.org" target="_blank">tom@openstack.org</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span class="">On 11/11/14 10:31, Anne Gentle wrote:<br>
><br>
><br>
> On Mon, Nov 10, 2014 at 8:24 PM, Tom Fifield <<a href="mailto:tom@openstack.org">tom@openstack.org</a><br>
</span><span class="">> <mailto:<a href="mailto:tom@openstack.org">tom@openstack.org</a>>> wrote:<br>
><br>
> On 11/11/14 10:22, Anne Gentle wrote:<br>
> ><br>
> ><br>
> > On Mon, Nov 10, 2014 at 8:20 PM, Tom Fifield <<a href="mailto:tom@openstack.org">tom@openstack.org</a> <mailto:<a href="mailto:tom@openstack.org">tom@openstack.org</a>><br>
</span><div><div class="h5">> > <mailto:<a href="mailto:tom@openstack.org">tom@openstack.org</a> <mailto:<a href="mailto:tom@openstack.org">tom@openstack.org</a>>>> wrote:<br>
> ><br>
> > On 11/11/14 10:19, Anne Gentle wrote:<br>
> > ><br>
> > ><br>
> > > On Mon, Nov 10, 2014 at 8:10 PM, Tom Fifield <<a href="mailto:tom@openstack.org">tom@openstack.org</a> <mailto:<a href="mailto:tom@openstack.org">tom@openstack.org</a>><br>
> <mailto:<a href="mailto:tom@openstack.org">tom@openstack.org</a> <mailto:<a href="mailto:tom@openstack.org">tom@openstack.org</a>>><br>
> > > <mailto:<a href="mailto:tom@openstack.org">tom@openstack.org</a> <mailto:<a href="mailto:tom@openstack.org">tom@openstack.org</a>><br>
> <mailto:<a href="mailto:tom@openstack.org">tom@openstack.org</a> <mailto:<a href="mailto:tom@openstack.org">tom@openstack.org</a>>>>> wrote:<br>
> > ><br>
> > > Hi,<br>
> > ><br>
> > > If I recall correctly, there was not consensus on this in the past.<br>
> > ><br>
> > > I have removed it, for now, on that basis.<br>
> > ><br>
> > ><br>
> > > Okay, let's start the discussion here then.<br>
> > ><br>
> > > I remember agreeing to American English for the Operations Guide.<br>
> ><br>
> > Actually, we agreed on the Atlantic standard :)<br>
> ><br>
> > > Can we agree to American English for the openstack-manuals?<br>
> ><br>
> > Actually, I don't think we need to agree on any standard.<br>
> ><br>
> ><br>
> > I'd like to have a convention to point to during reviews. Today I<br>
> > requested a revision of colours to colors and it would be great to point<br>
> > new contributors to a standard to follow.<br>
><br>
> I don't think this is useful or necessary at all. Adding such a standard<br>
> just means more pointless patchset revisions, wasting time of all<br>
> involved - which should be spent on fixing the enormous bug backlog.<br>
><br>
><br>
> Okay. Guess we'll have to disagree on this point. With the contributor<br>
> base we hope to reach I think we'll need the enhanced style guide that<br>
> Andreas is working on.<br>
><br>
> Again, the large bug backlog is due to the growth of projects, and we<br>
> need to onboard more contributors in order to get those numbers down and<br>
> better distributed.<br>
<br>
</div></div>Actually, these are quite related. Firstly, we need our existing<br>
contributors to be as efficient as they possibly can be to solve bugs.<br>
Changing a word to add in an additional character is not a valuable use<br>
of time. Secondly, we also need to be as welcoming as possible to every<br>
single person who's brave enough to get a patch up. At the moment we're<br>
alienating people.<br>
<br>
The stats cannot be explained entirely by 'project growth' - see Matt<br>
K's recent email, for example. Why did the number of significant<br>
contributors go down? Why do I get messages like this one after coaxing<br>
a technical expert to contribute?<br>
<br>
"""<br>
writing docs for openstack: never again<br>
the whole thing is poop and i refuse to comment again on<br>
that review, and if someone emails me asking to convert one of<br>
its blogs to docs i will say no, suffer, people googling this important<br>
thing can come to our website instead<br>
"""<br>
<br>
I was lucky enough in that case to get the contributor through, but note<br>
that the flatlining of contributions, time-wise, correlates with a<br>
marked increase in "Conventions" discussions.<br>
<br>
Changing 'colour' to 'color' might seem like a sensible thing to do, but<br>
in truth, it's stuff like that that's killing this project's ability to<br>
make things fun for volunteers.<br>
<br>
So, work on reducing the behemoth of the style guide is very welcome.<br>
Every additional patchset is (at least) a few minutes we don't spend<br>
working on another bug, or losing us potential long-term contributors<br>
(and friends ^_^).<br>
<div><div class="h5"><br>
<br>
> Anne<br>
><br>
><br>
> ><br>
><br>
> > Anne<br>
> ><br>
> ><br>
> ><br>
> ><br>
> > ><br>
> > ><br>
> > ><br>
> > > Regards,<br>
> > ><br>
> > ><br>
> > > Tom<br>
> > ><br>
> > > On 11/11/14 03:52, Anne Gentle wrote:<br>
> > > > Hi all,<br>
> > > > In the past we have had consensus around using American English<br>
> > > > spellings, so I added it to the Conventions page here:<br>
> > > ><br>
> > > ><br>
> > > <a href="https://wiki.openstack.org/wiki/Documentation/Conventions#Terms_and_usage" target="_blank">https://wiki.openstack.org/wiki/Documentation/Conventions#Terms_and_usage</a><br>
> > > ><br>
> > > > Wanted to bring it to the list to make sure it's generally known.<br>
> > > > Thanks,<br>
> > > > Anne<br>
> > > ><br>
> > > ><br>
> > > > _______________________________________________<br>
> > > > OpenStack-docs mailing list<br>
> > > > <a href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.openstack.org</a><br>
> <mailto:<a href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.openstack.org</a>><br>
> > <mailto:<a href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.openstack.org</a><br>
> <mailto:<a href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.openstack.org</a>>><br>
> > > <mailto:<a href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.openstack.org</a><br>
> <mailto:<a href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.openstack.org</a>><br>
> > <mailto:<a href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.openstack.org</a><br>
> <mailto:<a href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.openstack.org</a>>>><br>
> > > > <a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
> > > ><br>
> > ><br>
> > ><br>
> > > _______________________________________________<br>
> > > OpenStack-docs mailing list<br>
> > > <a href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.openstack.org</a><br>
> <mailto:<a href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.openstack.org</a>><br>
> > <mailto:<a href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.openstack.org</a><br>
> <mailto:<a href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.openstack.org</a>>><br>
> > > <mailto:<a href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.openstack.org</a><br>
> <mailto:<a href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.openstack.org</a>><br>
> > <mailto:<a href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.openstack.org</a><br>
</div></div>> <mailto:<a href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.openstack.org</a>>>><br>
> > ><br>
> <a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
> > ><br>
> > ><br>
> ><br>
> ><br>
><br>
><br>
<br>
</blockquote></div><br></div>