<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On Thu, Dec 22, 2016 at 8:32 AM, Doug Hellmann <span dir="ltr"><<a href="mailto:doug@doughellmann.com" target="_blank">doug@doughellmann.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Excerpts from Ian Cordasco's message of 2016-12-22 06:46:29 -0600:<br>
<span class="">><br>
> There is some ambiguity right now with projects as to where to put<br>
> easy-to-find documentation (even if it is just a brief paragraph with<br>
> a link to longer-form documentation) into our repositories. Let's<br>
> focus on that discussion here. We can come up with a productive<br>
> conclusion and work with this contributor. While you've chosen (and<br>
> yes, you've chosen this) to have a negative assumption about this<br>
> contributor's efforts, I've chosen to believe they're looking to fill<br>
> a gap. Increasing the productivity of new contributors to OpenStack is<br>
> a positive improvement for our community. It may not fix a bug or add<br>
> a feature, but it helps ramp up the people who will do that.<br>
<br>
</span>I thought we started adding these contributing files specifically<br>
because of how they are rendered on github, as a way to try to prevent<br>
folks from submitting pull requests there and then having them rejected<br>
by the bot. It seemed more positive to give direction ahead of time than<br>
through a rejection message.<br></blockquote><div><br></div><div>+1 to this and Ian and Alex's sentiments.</div><div><br></div><div>It'd be great to get people to click one more time (to a more specific contributor guide), but let's face it, there has to be a lot of traffic directly to <a href="http://github.com">github.com</a>. Let's make sure there's a decent entry.</div><div><br></div><div>Does anyone have a "perfect" CONTRIBUTING.rst (or does it need to be .md for github, Ian?) for all projects? Is it similar to the nova 2012 version or is there a more modern take?</div><div><br></div><div>Anne</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<span class="HOEnZb"><font color="#888888"><br>
Doug<br>
</font></span><div class="HOEnZb"><div class="h5"><br>
______________________________<wbr>______________________________<wbr>______________<br>
OpenStack Development Mailing List (not for usage questions)<br>
Unsubscribe: <a href="http://OpenStack-dev-request@lists.openstack.org?subject:unsubscribe" rel="noreferrer" target="_blank">OpenStack-dev-request@lists.<wbr>openstack.org?subject:<wbr>unsubscribe</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" rel="noreferrer" target="_blank">http://lists.openstack.org/<wbr>cgi-bin/mailman/listinfo/<wbr>openstack-dev</a><br>
</div></div></blockquote></div><br><br clear="all"><div><br></div>-- <br><div class="gmail_signature" data-smartmail="gmail_signature"><div dir="ltr"><div><div dir="ltr"><div dir="ltr"><div dir="ltr"><div><br></div><div>Read my blog: <a href="https://justwriteclick.com" target="_blank">justwrite.click</a></div><div>Subscribe to Docs|Code: <a href="http://docslikecode.com" target="_blank">docslikecode.com</a> </div></div></div></div></div></div></div>
</div></div>