Re: [openstack-dev] [all] Adding CONTRIBUTING.rst files to projects

Excerpts from Andreas Jaeger's message of 2017-01-03 19:29:25 +0100: > On 01/03/2017 05:59 PM, Anne Gentle wrote: > > > > What happens is you get a special notification and link to > > CONTRIBUTING.txt (or rst, but only after comparing branches) as in this > > screenshot: > > > >

Re: [openstack-dev] [all] Adding CONTRIBUTING.rst files to projects

On 01/03/2017 05:59 PM, Anne Gentle wrote: > > What happens is you get a special notification and link to > CONTRIBUTING.txt (or rst, but only after comparing branches) as in this > screenshot: > > https://postimg.org/image/wple5yudr/ > > But, based on testing, it's fine to keep what we have

Re: [openstack-dev] [all] Adding CONTRIBUTING.rst files to projects

On Tue, Jan 3, 2017 at 10:47 AM, Doug Hellmann wrote: > Excerpts from Anne Gentle's message of 2017-01-03 10:26:28 -0600: > > On Tue, Jan 3, 2017 at 12:04 AM, Andreas Jaeger wrote: > > > > > On 01/03/2017 04:01 AM, Anne Gentle wrote: > > > > [...] > > > >

Re: [openstack-dev] [all] Adding CONTRIBUTING.rst files to projects

Excerpts from Anne Gentle's message of 2017-01-03 10:26:28 -0600: > On Tue, Jan 3, 2017 at 12:04 AM, Andreas Jaeger wrote: > > > On 01/03/2017 04:01 AM, Anne Gentle wrote: > > > [...] > > > Doug, I think the include in Sphinx can be a raw txt file? Then we get > > > the best of

Re: [openstack-dev] [all] Adding CONTRIBUTING.rst files to projects

On Tue, Jan 3, 2017 at 12:04 AM, Andreas Jaeger wrote: > On 01/03/2017 04:01 AM, Anne Gentle wrote: > > [...] > > Doug, I think the include in Sphinx can be a raw txt file? Then we get > > the best of both worlds - rendered on both docs.openstack.org > >

Re: [openstack-dev] [all] Adding CONTRIBUTING.rst files to projects

Excerpts from Andreas Jaeger's message of 2017-01-03 07:04:51 +0100: > On 01/03/2017 04:01 AM, Anne Gentle wrote: > > [...] > > Doug, I think the include in Sphinx can be a raw txt file? Then we get > > the best of both worlds - rendered on both docs.openstack.org > >

Re: [openstack-dev] [all] Adding CONTRIBUTING.rst files to projects

On 01/03/2017 04:01 AM, Anne Gentle wrote: > [...] > Doug, I think the include in Sphinx can be a raw txt file? Then we get > the best of both worlds - rendered on both docs.openstack.org > and github.com . We do not need an rst file, github handles

Re: [openstack-dev] [all] Adding CONTRIBUTING.rst files to projects

) < > openstack-dev@lists.openstack.org> > > > Subject: Re: [openstack-dev] [all] Adding CONTRIBUTING.rst files to > projects > > > > > > > On Wed, Dec 21, 2016 at 5:46 PM, Andreas Jaeger wrote: > > > > > > > > &

Re: [openstack-dev] [all] Adding CONTRIBUTING.rst files to projects

st (not for usage questions) > > <openstack-dev@lists.openstack.org> > > Date: December 21, 2016 at 10:13:09 > > To: OpenStack Development Mailing List (not for usage questions) > > <openstack-dev@lists.openstack.org> > > Subject:  Re: [openstack-dev] [all] Adding CONTRIB

Re: [openstack-dev] [all] Adding CONTRIBUTING.rst files to projects

cember 21, 2016 at 10:13:09 > To: OpenStack Development Mailing List (not for usage questions) > <openstack-dev@lists.openstack.org> > Subject:  Re: [openstack-dev] [all] Adding CONTRIBUTING.rst files to projects > > > On Wed, Dec 21, 2016 at 5:46 PM, Andreas Jaeger wrote:

Re: [openstack-dev] [all] Adding CONTRIBUTING.rst files to projects

age- > From: Jeremy Stanley [mailto:fu...@yuggoth.org] > Sent: Saturday, December 24, 2016 9:58 AM > To: OpenStack Development Mailing List (not for usage questions) > <openstack-dev@lists.openstack.org> > Subject: Re: [openstack-dev] [all] Adding CONTRIBUTING.rst files to

Re: [openstack-dev] [all] Adding CONTRIBUTING.rst files to projects

On 2016-12-22 09:52:21 -0600 (-0600), Anne Gentle wrote: [...] > 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? The reference example is maintained at

Re: [openstack-dev] [all] Adding CONTRIBUTING.rst files to projects

On Thu, Dec 22, 2016 at 10:47 AM, Andreas Jaeger wrote: > On 12/22/2016 04:52 PM, Anne Gentle wrote: > > > > > > On Thu, Dec 22, 2016 at 8:32 AM, Doug Hellmann > > wrote: > > > > Excerpts from Ian Cordasco's message of

Re: [openstack-dev] [all] Adding CONTRIBUTING.rst files to projects

On 12/22/2016 04:52 PM, Anne Gentle wrote: > > > On Thu, Dec 22, 2016 at 8:32 AM, Doug Hellmann > wrote: > > Excerpts from Ian Cordasco's message of 2016-12-22 06:46:29 -0600: > > > > There is some ambiguity right now with

Re: [openstack-dev] [all] Adding CONTRIBUTING.rst files to projects

On 21/12/16 07:22 -0800, Ian Cordasco wrote: Hey everyone, It seems a contributor has written a script to add CONTRIBUTING.rst files to each OpenStack project that exists. [1] As a community we've struggled with new contributors creating tonnes of patches like this at once, and that is

Re: [openstack-dev] [all] Adding CONTRIBUTING.rst files to projects

On Thu, Dec 22, 2016 at 8:32 AM, Doug Hellmann wrote: > Excerpts from Ian Cordasco's message of 2016-12-22 06:46:29 -0600: > > > > There is some ambiguity right now with projects as to where to put > > easy-to-find documentation (even if it is just a brief paragraph with >

Re: [openstack-dev] [all] Adding CONTRIBUTING.rst files to projects

Excerpts from Ian Cordasco's message of 2016-12-22 06:46:29 -0600: > > There is some ambiguity right now with projects as to where to put > easy-to-find documentation (even if it is just a brief paragraph with > a link to longer-form documentation) into our repositories. Let's > focus on that

Re: [openstack-dev] [all] Adding CONTRIBUTING.rst files to projects

t;> From: Amrith Kumar [mailto:amr...@tesora.com] >> Sent: Wednesday, December 21, 2016 11:13 AM >> To: OpenStack Development Mailing List (not for usage questions) >> <openstack-dev@lists.openstack.org> >> Subject: Re: [openstack-dev] [all] Adding CON

Re: [openstack-dev] [all] Adding CONTRIBUTING.rst files to projects

OpenStack Development Mailing List (not for usage questions) >> <openstack-dev@lists.openstack.org> >> Subject: Re: [openstack-dev] [all] Adding CONTRIBUTING.rst files to >> projects >> >> Ian, Andreas, Emilien, >> >> My sentiments on the subje

Re: [openstack-dev] [all] Adding CONTRIBUTING.rst files to projects

> -Original Message- > From: Amrith Kumar [mailto:amr...@tesora.com] > Sent: Wednesday, December 21, 2016 11:13 AM > To: OpenStack Development Mailing List (not for usage questions) < > openstack-dev@lists.openstack.org> > Subject: Re: [openstack-dev] [all] Adding CONTR

Re: [openstack-dev] [all] Adding CONTRIBUTING.rst files to projects

To: OpenStack Development Mailing List (not for usage questions) <openstack-dev@lists.openstack.org> Subject: Re: [openstack-dev] [all] Adding CONTRIBUTING.rst files to projects Ian, Andreas, Emilien, My sentiments on the subject of these kinds of "production line" changes is u

Re: [openstack-dev] [all] Adding CONTRIBUTING.rst files to projects

m: Andreas Jaeger [mailto:a...@suse.com] Sent: Wednesday, December 21, 2016 10:47 AM To: OpenStack Development Mailing List (not for usage questions) <openstack-dev@lists.openstack.org> Subject: Re: [openstack-dev] [all] Adding CONTRIBUTING.rst files to projects On 2016-12-21 16:22, Ia

Re: [openstack-dev] [all] Adding CONTRIBUTING.rst files to projects

t;openstack-dev@lists.openstack.org> Subject:  Re: [openstack-dev] [all] Adding CONTRIBUTING.rst files to projects > Hi stackers! > > On Wed, Dec 21, 2016 at 5:33 PM, Emilien Macchi wrote: > > > On Wed, Dec 21, 2016 at 10:22 AM, Ian Cordasco > > wrote: > > > H

Re: [openstack-dev] [all] Adding CONTRIBUTING.rst files to projects

t;openstack-dev@lists.openstack.org> Subject:  Re: [openstack-dev] [all] Adding CONTRIBUTING.rst files to projects > On Wed, Dec 21, 2016 at 5:46 PM, Andreas Jaeger wrote: > > > On 2016-12-21 16:22, Ian Cordasco wrote: > > > [...] > > > That said, I think

Re: [openstack-dev] [all] Adding CONTRIBUTING.rst files to projects

On Wed, Dec 21, 2016 at 5:46 PM, Andreas Jaeger wrote: > On 2016-12-21 16:22, Ian Cordasco wrote: > > [...] > > That said, I think there are two better places for this information > > that are already standards in OpenStack: > > > > * README.rst > > * HACKING.rst > > > > Most

Re: [openstack-dev] [all] Adding CONTRIBUTING.rst files to projects

Hi stackers! On Wed, Dec 21, 2016 at 5:33 PM, Emilien Macchi wrote: > On Wed, Dec 21, 2016 at 10:22 AM, Ian Cordasco > wrote: > > Hey everyone, > > > > It seems a contributor has written a script to add CONTRIBUTING.rst > > files to each OpenStack

Re: [openstack-dev] [all] Adding CONTRIBUTING.rst files to projects

t;openstack-dev@lists.openstack.org> Subject:  Re: [openstack-dev] [all] Adding CONTRIBUTING.rst files to projects > On 2016-12-21 16:22, Ian Cordasco wrote: > > [...] > > That said, I think there are two better places for this information > > that are already standards in OpenStack:

Re: [openstack-dev] [all] Adding CONTRIBUTING.rst files to projects

On 2016-12-21 16:22, Ian Cordasco wrote: > [...] > That said, I think there are two better places for this information > that are already standards in OpenStack: > > * README.rst > * HACKING.rst > > Most projects include links to the contributing documentation in at > least one of these files. I

Re: [openstack-dev] [all] Adding CONTRIBUTING.rst files to projects

On Wed, Dec 21, 2016 at 10:22 AM, Ian Cordasco wrote: > Hey everyone, > > It seems a contributor has written a script to add CONTRIBUTING.rst > files to each OpenStack project that exists. [1] Thanks Ian for starting this discussion, it's very appreciated. It would have

[openstack-dev] [all] Adding CONTRIBUTING.rst files to projects

Hey everyone, It seems a contributor has written a script to add CONTRIBUTING.rst files to each OpenStack project that exists. [1] As a community we've struggled with new contributors creating tonnes of patches like this at once, and that is emphatically not the purpose of this email. Instead,