<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On Wed, Dec 21, 2016 at 5:46 PM, 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">On 2016-12-21 16:22, Ian Cordasco wrote:<br>
> [...]<br>
<span class="gmail-">> That said, I think there are two better places for this information<br>
> that are already standards in OpenStack:<br>
><br>
> * README.rst<br>
> * HACKING.rst<br>
><br>
> Most projects include links to the contributing documentation in at<br>
> least one of these files. I think the effort here is to standardize,<br>
> albeit in a brand new file, and that's admirable.<br>
<br>
</span>If that's the goal - to standardize - then I would expect that we move<br>
all the documentation out of those files in one place.<br>
<br>
Right now, the changes duplicate information that exists - and the new<br>
information is often wrong. It points to place that do not exist or<br>
where better places exist. ;(<br></blockquote><div><br></div><div>Duplication can be reduced by using `.. include:: ` directive.<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
<br>
<br>
I'm fine with the status quo - of using the two files that you mention.<br>
Having contribution information is important,<br>
<br>
Andreas<br>
<span class="gmail-HOEnZb"><font color="#888888">--<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>
</font></span><div class="gmail-HOEnZb"><div class="gmail-h5"><br>
<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"><br>-- <br><div class="gmail_signature"><div dir="ltr">Best regards,<br>Andrey Kurilin.<br></div></div>
</div></div>