<div dir="ltr"><div class="gmail_default" style="font-family:monospace,monospace"><span style="font-family:arial,sans-serif">On 28 May 2018 at 15:40, Petr Kovar </span><span dir="ltr" style="font-family:arial,sans-serif"><<a href="mailto:pkovar@redhat.com">pkovar@redhat.com</a>></span><span style="font-family:arial,sans-serif"> wrote:</span><br></div><div class="gmail_extra"><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">On Thu, 17 May 2018 15:03:23 +0000<br>
<div><div class="h5">Jeremy Stanley <<a href="mailto:fungi@yuggoth.org">fungi@yuggoth.org</a>> wrote:<br>
<br>
> On 2018-05-17 16:35:36 +0200 (+0200), Petr Kovar wrote:<br></div></div></blockquote><div><br></div><div class="gmail_default" style="font-family:monospace,monospace">​%<-----</div><div class="gmail_default" style="font-family:monospace,monospace">​</div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div><div class="h5"></div></div>I'm all for openness but maintaining consistency is why style guides<br>
matter. Switching to a different style guide would require the following:<br>
<br>
1) agreeing on the right style guide,<br>
2) reviewing our current style guidelines in doc-contrib-guide and updating<br>
them as needed so that they comply with the new style guide, and,<br>
3) ideally, begin reviewing all of OpenStack docs for style changes.<br>
<br>
Do we have a volunteer who would be interested in taking on these tasks? If<br>
not, we have to go for a quick fix. Either reference developerWorks, or, if<br>
that's a concern, remove references to external style guides<br>
altogether (and provide less information as a result). I prefer the former.<br>
<br>
Cheers,<br>
<div class="HOEnZb"><div class="h5">pk<br></div></div></blockquote><div><br></div><div class="gmail_default" style="font-family:monospace,monospace">Petr,<br>​do we really need to reference to another style guide? <br>How many times people clicked on the link to the IBM guide?​</div><div class="gmail_default" style="font-family:monospace,monospace"><br></div><div class="gmail_default" style="font-family:monospace,monospace">If first answer is yes and second is hundreds of times </div><div class="gmail_default" style="font-family:monospace,monospace">than in my opinion you first option is the right one </div><div class="gmail_default" style="font-family:monospace,monospace">otherwise I'd go for the second.</div><div class="gmail_default" style="font-family:monospace,monospace"><br></div><div class="gmail_default" style="font-family:monospace,monospace">My 2¢</div><div class="gmail_default" style="font-family:monospace,monospace">Stefano</div><div class="gmail_default" style="font-family:monospace,monospace"><br></div><div class="gmail_default" style="font-family:monospace,monospace">PS: a good free doc style guideline is the gnome one.</div><div class="gmail_default" style="font-family:monospace,monospace"><br></div></div></div></div>