<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
</head>
<body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; color: rgb(0, 0, 0); font-size: 15px; font-family: Calibri, sans-serif;">
<div>I value the friendliness and approachability that contributors seek.</div>
<div><br>
</div>
<div>I am totally fine with minor mistakes in documentation.</div>
<div><br>
</div>
<div>As they make more changes, they will understand/follow the process.</div>
<div><br>
</div>
<div>+1</div>
<div><br>
</div>
<div><br>
</div>
<div>Regards,</div>
<div>Vikram Hosakote</div>
<div>IRC: vhosakot</div>
<div><br>
</div>
<span id="OLK_SRC_BODY_SECTION">
<div style="font-family:Calibri; font-size:11pt; text-align:left; color:black; BORDER-BOTTOM: medium none; BORDER-LEFT: medium none; PADDING-BOTTOM: 0in; PADDING-LEFT: 0in; PADDING-RIGHT: 0in; BORDER-TOP: #b5c4df 1pt solid; BORDER-RIGHT: medium none; PADDING-TOP: 3pt">
<span style="font-weight:bold">From: </span>"Steven Dake (stdake)" <<a href="mailto:stdake@cisco.com">stdake@cisco.com</a>><br>
<span style="font-weight:bold">Reply-To: </span>"OpenStack Development Mailing List (not for usage questions)" <<a href="mailto:openstack-dev@lists.openstack.org">openstack-dev@lists.openstack.org</a>><br>
<span style="font-weight:bold">Date: </span>Monday, April 11, 2016 at 3:37 AM<br>
<span style="font-weight:bold">To: </span>"OpenStack Development Mailing List (not for usage questions)" <<a href="mailto:openstack-dev@lists.openstack.org">openstack-dev@lists.openstack.org</a>><br>
<span style="font-weight:bold">Subject: </span>[openstack-dev] [kolla][vote] Nit-picking documentation changes<br>
</div>
<div><br>
</div>
<div>
<div style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; color: rgb(0, 0, 0); font-size: 14px; font-family: Calibri, sans-serif;">
<div>Hey folks,</div>
<div><br>
</div>
<div>The reviewers in Kolla tend to nit-pick the quickstart guide to death during reviews. I'd like to keep that high bar in place for the QSG, because it is our most important piece of documentation at present. 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.</div>
<div><br>
</div>
<div>I'd prefer if the core reviewers held a lower bar for docs not related to the philosophy or quiickstart guide document. We can always iterate on these new documents (like the operator guide) to improve them and raise the bar on their quality over time,
as we have done with the quickstart guide. That way contributors don't feel nitpicked to death and avoid improving the documentation.</div>
<div><br>
</div>
<div>If you are a core reveiwer and agree with this approach please +1, if not please –1.</div>
<div><br>
</div>
<div>This is an unofficial vote and carries no commitment from the core reviewers, but I've included vote in the subject just to catch people's attention and to get folks thoughts on this matter.</div>
<div><br>
</div>
<div>Regards</div>
<div>-steve</div>
<div><br>
</div>
<div><br>
</div>
</div>
</div>
</span>
</body>
</html>