<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On Thu, Dec 22, 2016 at 10:47 AM, Andreas Jaeger <span dir="ltr"><<a href="mailto:aj@suse.com" target="_blank">aj@suse.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><span class="gmail-">On 12/22/2016 04:52 PM, Anne Gentle wrote:<br>
><br>
><br>
> On Thu, Dec 22, 2016 at 8:32 AM, Doug Hellmann <<a href="mailto:doug@doughellmann.com">doug@doughellmann.com</a><br>
</span><span class="gmail-">> <mailto:<a href="mailto:doug@doughellmann.com">doug@doughellmann.com</a>><wbr>> wrote:<br>
><br>
>     Excerpts from Ian Cordasco's message of 2016-12-22 06:46:29 -0600:<br>
>     ><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>
>     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>
><br>
><br>
> +1 to this and Ian and Alex's sentiments.<br>
><br>
> It'd be great to get people to click one more time (to a more specific<br>
> contributor guide), but let's face it, there has to be a lot of traffic<br>
</span>> directly to <a href="http://github.com" rel="noreferrer" target="_blank">github.com</a> <<a href="http://github.com" rel="noreferrer" target="_blank">http://github.com</a>>. Let's make sure there's a<br>
<span class="gmail-">> decent entry.<br>
><br>
> Does anyone have a "perfect" CONTRIBUTING.rst (or does it need to be .md<br>
> for github, Ian?) for all projects? Is it similar to the nova 2012<br>
> version or is there a more modern take?<br>
<br>
<br>
</span>I'm against *only* adding a CONTRIBUTING.rst file. Any such change,<br>
should remove the existing content so that we have no duplication. If we<br>
document in two or three places how to contribute, one will be out of sync.<br>
<br>
So, a well done patch would be welcome - but not just adding a file with<br>
wrong information and no integration into existing content,.<br></blockquote><div> <br></div><div><br></div><div>Sure, let's get accurate info, but the scenario I'm thinking of is this one:</div><div><a href="https://help.github.com/articles/setting-guidelines-for-repository-contributors/">https://help.github.com/articles/setting-guidelines-for-repository-contributors/</a><br></div><div><br></div><div>Where the link is automatically displayed.</div><div><br></div><div>Anne</div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
<span class="gmail-im gmail-HOEnZb"><br>
Andreas<br>
--<br>
 Andreas Jaeger aj@{<a href="http://suse.com" rel="noreferrer" target="_blank">suse.com</a>,<a href="http://opensuse.org" rel="noreferrer" target="_blank">opensuse.org</a>} Twitter: jaegerandi<br>
  SUSE LINUX GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany<br>
   GF: Felix Imendörffer, Jane Smithard, Graham Norton,<br>
       HRB 21284 (AG Nürnberg)<br>
    GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126<br>
<br>
<br>
</span><div class="gmail-HOEnZb"><div class="gmail-h5">______________________________<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"><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>