Re: [openstack-dev] [neutron] Updates to the template for Neutron BPs
Great! Thanks Anne! On 22 April 2014 16:44, Anne Gentle wrote: > > > > On Tue, Apr 22, 2014 at 4:42 AM, Jaume Devesa wrote: > >> Another question about this, Kyle: >> >> once merged, will there be a place where to read these approved specs, or >> should we run it locally? I tried to find the approved *nova-specs *in >> docs.openstack.org, but I couldn't find them. >> >> > Hi Jaume, > Since these are specifications and not created features (yet), they will > not be published on docs.openstack.org but on specs.openstack.org/$project > . > > See http://markmail.org/message/du6djpz3unbdgzpm for more details. I > don't believe the site is set up quite yet. > > Thanks, > Anne > > > >> Regards, >> jaume >> >> >> On 21 April 2014 09:02, Mandeep Dhami wrote: >> >>> >>> Got it. Thanks. >>> >>> Regards, >>> Mandeep >>> >>> >>> On Sun, Apr 20, 2014 at 11:49 PM, Mike Scherbakov < >>> mscherba...@mirantis.com> wrote: >>> That's because spec was proposed to the juno/ folder. Look at https://raw.githubusercontent.com/openstack/neutron-specs/master/doc/source/index.rst, if spec is in juno/ folder, then contents shows it as approved one. Once merged, it means approved, right? So it is going to be Ok after merge. Though a better reminding than just "draft" in the url could be required if many start to mess it up... On Mon, Apr 21, 2014 at 10:43 AM, Kevin Benton wrote: > Yes. It shows up in the approved section since it's just a build of > the patch as-is. > > The link is titled gate-neutron-specs-docs in the message from Jenkins. > > -- > Kevin Benton > > > On Sun, Apr 20, 2014 at 11:37 PM, Mandeep Dhami < > dh...@noironetworks.com> wrote: > >> Just for clarification. Jenkins link in the description puts the >> generated HTML in the section "Juno approved specs" even tho' the >> blueprint is still being reviewed. Am I looking at the right link? >> >> Regards, >> Mandeep >> >> >> On Sun, Apr 20, 2014 at 10:54 PM, Mike Scherbakov < >> mscherba...@mirantis.com> wrote: >> >>> Yes, thanks, that's exactly what I was looking for! >>> >>> >>> On Mon, Apr 21, 2014 at 12:03 AM, Kyle Mestery < >>> mest...@noironetworks.com> wrote: >>> On Sat, Apr 19, 2014 at 5:11 PM, Mike Scherbakov wrote: > Hi Kyle, > I built template and it looks awesome. We are considering to use same > approach for Fuel. > > My assumption is that spec will be on review for a negotiation time, which > is going to be quite a while. In my opinion, it is not always very > convenient to read spec in gerrit. > Agreed, though for some specs, this is actually an ok way to do reviews. > Did you guys have any thoughts on auto-build these specs into html on every > patch upload? So we could go somewhere and see built results, without a > requirement to fetch neutron-specs, and run tox? The possible drawback is > that reader won't see gerrit comments.. > I followed what Nova was going and committed code into openstack-infra/config which allows for some jenkins jobs to run when we commit to the neutron-specs gerrit. [1]. As an example, look at this commit here [2]. If you look at the latest Jenkins run, you'll see a link which takes you to an HTML generated document [3] which you can review in lieu of the raw restructured text in gerrit. That will actually generate all the specs in the repository, so you'll see the "Example Spec" along with the Nuage one I used for reference here. Hope that helps! Kyle [1] https://review.openstack.org/#/c/88069/ [2] https://review.openstack.org/#/c/88690/ [3] http://docs-draft.openstack.org/90/88690/3/check/gate-neutron-specs-docs/fe4282a/doc/build/html/ > Thanks, > > > On Sat, Apr 19, 2014 at 12:08 AM, Kyle Mestery < mest...@noironetworks.com> > wrote: >> >> Hi folks: >> >> I just wanted to let people know that we've merged a few patches [1] >> to the neutron-specs repository over the past week which have updated >> the template.rst file. Specifically, Nachi has provided some >> instructions for using Sphinx diagram tools in lieu of asciiflow.com. >> Either approach is fine for any Neutron BP submissions, but Nachi's >> patch has some examples of using both approaches. Bob merged a patch >> which shows an example of defining REST APIs with attribute tables. >> >> Just an update for anyo
Re: [openstack-dev] [neutron] Updates to the template for Neutron BPs
On Tue, Apr 22, 2014 at 4:42 AM, Jaume Devesa wrote: > Another question about this, Kyle: > > once merged, will there be a place where to read these approved specs, or > should we run it locally? I tried to find the approved *nova-specs *in > docs.openstack.org, but I couldn't find them. > > Hi Jaume, Since these are specifications and not created features (yet), they will not be published on docs.openstack.org but on specs.openstack.org/$project. See http://markmail.org/message/du6djpz3unbdgzpm for more details. I don't believe the site is set up quite yet. Thanks, Anne > Regards, > jaume > > > On 21 April 2014 09:02, Mandeep Dhami wrote: > >> >> Got it. Thanks. >> >> Regards, >> Mandeep >> >> >> On Sun, Apr 20, 2014 at 11:49 PM, Mike Scherbakov < >> mscherba...@mirantis.com> wrote: >> >>> That's because spec was proposed to the juno/ folder. Look at >>> https://raw.githubusercontent.com/openstack/neutron-specs/master/doc/source/index.rst, >>> if spec is in juno/ folder, then contents shows it as approved one. >>> >>> Once merged, it means approved, right? So it is going to be Ok after >>> merge. Though a better reminding than just "draft" in the url could be >>> required if many start to mess it up... >>> >>> >>> On Mon, Apr 21, 2014 at 10:43 AM, Kevin Benton wrote: >>> Yes. It shows up in the approved section since it's just a build of the patch as-is. The link is titled gate-neutron-specs-docs in the message from Jenkins. -- Kevin Benton On Sun, Apr 20, 2014 at 11:37 PM, Mandeep Dhami < dh...@noironetworks.com> wrote: > Just for clarification. Jenkins link in the description puts the > generated HTML in the section "Juno approved specs" even tho' the > blueprint is still being reviewed. Am I looking at the right link? > > Regards, > Mandeep > > > On Sun, Apr 20, 2014 at 10:54 PM, Mike Scherbakov < > mscherba...@mirantis.com> wrote: > >> Yes, thanks, that's exactly what I was looking for! >> >> >> On Mon, Apr 21, 2014 at 12:03 AM, Kyle Mestery < >> mest...@noironetworks.com> wrote: >> >>> On Sat, Apr 19, 2014 at 5:11 PM, Mike Scherbakov >>> wrote: >>> > Hi Kyle, >>> > I built template and it looks awesome. We are considering to use >>> same >>> > approach for Fuel. >>> > >>> > My assumption is that spec will be on review for a negotiation >>> time, which >>> > is going to be quite a while. In my opinion, it is not always very >>> > convenient to read spec in gerrit. >>> > >>> Agreed, though for some specs, this is actually an ok way to do >>> reviews. >>> >>> > Did you guys have any thoughts on auto-build these specs into html >>> on every >>> > patch upload? So we could go somewhere and see built results, >>> without a >>> > requirement to fetch neutron-specs, and run tox? The possible >>> drawback is >>> > that reader won't see gerrit comments.. >>> > >>> I followed what Nova was going and committed code into >>> openstack-infra/config which allows for some jenkins jobs to run when >>> we commit to the neutron-specs gerrit. [1]. As an example, look at >>> this commit here [2]. If you look at the latest Jenkins run, you'll >>> see a link which takes you to an HTML generated document [3] which >>> you >>> can review in lieu of the raw restructured text in gerrit. That will >>> actually generate all the specs in the repository, so you'll see the >>> "Example Spec" along with the Nuage one I used for reference here. >>> >>> Hope that helps! >>> Kyle >>> >>> [1] https://review.openstack.org/#/c/88069/ >>> [2] https://review.openstack.org/#/c/88690/ >>> [3] >>> http://docs-draft.openstack.org/90/88690/3/check/gate-neutron-specs-docs/fe4282a/doc/build/html/ >>> >>> > Thanks, >>> > >>> > >>> > On Sat, Apr 19, 2014 at 12:08 AM, Kyle Mestery < >>> mest...@noironetworks.com> >>> > wrote: >>> >> >>> >> Hi folks: >>> >> >>> >> I just wanted to let people know that we've merged a few patches >>> [1] >>> >> to the neutron-specs repository over the past week which have >>> updated >>> >> the template.rst file. Specifically, Nachi has provided some >>> >> instructions for using Sphinx diagram tools in lieu of >>> asciiflow.com. >>> >> Either approach is fine for any Neutron BP submissions, but >>> Nachi's >>> >> patch has some examples of using both approaches. Bob merged a >>> patch >>> >> which shows an example of defining REST APIs with attribute >>> tables. >>> >> >>> >> Just an update for anyone proposing BPs for Juno at the moment. >>> >> >>> >> Thanks! >>> >> Kyle >>> >> >>> >> [1] >>> >> >>> https://review.openstack.org/#/q/status:merged+project:openstack/neutron-specs,n,z >>> >> >>> >
Re: [openstack-dev] [neutron] Updates to the template for Neutron BPs
Another question about this, Kyle: once merged, will there be a place where to read these approved specs, or should we run it locally? I tried to find the approved *nova-specs *in docs.openstack.org, but I couldn't find them. Regards, jaume On 21 April 2014 09:02, Mandeep Dhami wrote: > > Got it. Thanks. > > Regards, > Mandeep > > > On Sun, Apr 20, 2014 at 11:49 PM, Mike Scherbakov < > mscherba...@mirantis.com> wrote: > >> That's because spec was proposed to the juno/ folder. Look at >> https://raw.githubusercontent.com/openstack/neutron-specs/master/doc/source/index.rst, >> if spec is in juno/ folder, then contents shows it as approved one. >> >> Once merged, it means approved, right? So it is going to be Ok after >> merge. Though a better reminding than just "draft" in the url could be >> required if many start to mess it up... >> >> >> On Mon, Apr 21, 2014 at 10:43 AM, Kevin Benton wrote: >> >>> Yes. It shows up in the approved section since it's just a build of the >>> patch as-is. >>> >>> The link is titled gate-neutron-specs-docs in the message from Jenkins. >>> >>> -- >>> Kevin Benton >>> >>> >>> On Sun, Apr 20, 2014 at 11:37 PM, Mandeep Dhami >> > wrote: >>> Just for clarification. Jenkins link in the description puts the generated HTML in the section "Juno approved specs" even tho' the blueprint is still being reviewed. Am I looking at the right link? Regards, Mandeep On Sun, Apr 20, 2014 at 10:54 PM, Mike Scherbakov < mscherba...@mirantis.com> wrote: > Yes, thanks, that's exactly what I was looking for! > > > On Mon, Apr 21, 2014 at 12:03 AM, Kyle Mestery < > mest...@noironetworks.com> wrote: > >> On Sat, Apr 19, 2014 at 5:11 PM, Mike Scherbakov >> wrote: >> > Hi Kyle, >> > I built template and it looks awesome. We are considering to use >> same >> > approach for Fuel. >> > >> > My assumption is that spec will be on review for a negotiation >> time, which >> > is going to be quite a while. In my opinion, it is not always very >> > convenient to read spec in gerrit. >> > >> Agreed, though for some specs, this is actually an ok way to do >> reviews. >> >> > Did you guys have any thoughts on auto-build these specs into html >> on every >> > patch upload? So we could go somewhere and see built results, >> without a >> > requirement to fetch neutron-specs, and run tox? The possible >> drawback is >> > that reader won't see gerrit comments.. >> > >> I followed what Nova was going and committed code into >> openstack-infra/config which allows for some jenkins jobs to run when >> we commit to the neutron-specs gerrit. [1]. As an example, look at >> this commit here [2]. If you look at the latest Jenkins run, you'll >> see a link which takes you to an HTML generated document [3] which you >> can review in lieu of the raw restructured text in gerrit. That will >> actually generate all the specs in the repository, so you'll see the >> "Example Spec" along with the Nuage one I used for reference here. >> >> Hope that helps! >> Kyle >> >> [1] https://review.openstack.org/#/c/88069/ >> [2] https://review.openstack.org/#/c/88690/ >> [3] >> http://docs-draft.openstack.org/90/88690/3/check/gate-neutron-specs-docs/fe4282a/doc/build/html/ >> >> > Thanks, >> > >> > >> > On Sat, Apr 19, 2014 at 12:08 AM, Kyle Mestery < >> mest...@noironetworks.com> >> > wrote: >> >> >> >> Hi folks: >> >> >> >> I just wanted to let people know that we've merged a few patches >> [1] >> >> to the neutron-specs repository over the past week which have >> updated >> >> the template.rst file. Specifically, Nachi has provided some >> >> instructions for using Sphinx diagram tools in lieu of >> asciiflow.com. >> >> Either approach is fine for any Neutron BP submissions, but Nachi's >> >> patch has some examples of using both approaches. Bob merged a >> patch >> >> which shows an example of defining REST APIs with attribute tables. >> >> >> >> Just an update for anyone proposing BPs for Juno at the moment. >> >> >> >> Thanks! >> >> Kyle >> >> >> >> [1] >> >> >> https://review.openstack.org/#/q/status:merged+project:openstack/neutron-specs,n,z >> >> >> >> ___ >> >> OpenStack-dev mailing list >> >> OpenStack-dev@lists.openstack.org >> >> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev >> > >> > >> > >> > >> > -- >> > Mike Scherbakov >> > #mihgen >> > >> > ___ >> > OpenStack-dev mailing list >> > OpenStack-dev@lists.openstack.org >> > http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev >> > >> >>>
Re: [openstack-dev] [neutron] Updates to the template for Neutron BPs
Got it. Thanks. Regards, Mandeep On Sun, Apr 20, 2014 at 11:49 PM, Mike Scherbakov wrote: > That's because spec was proposed to the juno/ folder. Look at > https://raw.githubusercontent.com/openstack/neutron-specs/master/doc/source/index.rst, > if spec is in juno/ folder, then contents shows it as approved one. > > Once merged, it means approved, right? So it is going to be Ok after > merge. Though a better reminding than just "draft" in the url could be > required if many start to mess it up... > > > On Mon, Apr 21, 2014 at 10:43 AM, Kevin Benton wrote: > >> Yes. It shows up in the approved section since it's just a build of the >> patch as-is. >> >> The link is titled gate-neutron-specs-docs in the message from Jenkins. >> >> -- >> Kevin Benton >> >> >> On Sun, Apr 20, 2014 at 11:37 PM, Mandeep Dhami >> wrote: >> >>> Just for clarification. Jenkins link in the description puts the >>> generated HTML in the section "Juno approved specs" even tho' the >>> blueprint is still being reviewed. Am I looking at the right link? >>> >>> Regards, >>> Mandeep >>> >>> >>> On Sun, Apr 20, 2014 at 10:54 PM, Mike Scherbakov < >>> mscherba...@mirantis.com> wrote: >>> Yes, thanks, that's exactly what I was looking for! On Mon, Apr 21, 2014 at 12:03 AM, Kyle Mestery < mest...@noironetworks.com> wrote: > On Sat, Apr 19, 2014 at 5:11 PM, Mike Scherbakov > wrote: > > Hi Kyle, > > I built template and it looks awesome. We are considering to use same > > approach for Fuel. > > > > My assumption is that spec will be on review for a negotiation time, > which > > is going to be quite a while. In my opinion, it is not always very > > convenient to read spec in gerrit. > > > Agreed, though for some specs, this is actually an ok way to do > reviews. > > > Did you guys have any thoughts on auto-build these specs into html > on every > > patch upload? So we could go somewhere and see built results, > without a > > requirement to fetch neutron-specs, and run tox? The possible > drawback is > > that reader won't see gerrit comments.. > > > I followed what Nova was going and committed code into > openstack-infra/config which allows for some jenkins jobs to run when > we commit to the neutron-specs gerrit. [1]. As an example, look at > this commit here [2]. If you look at the latest Jenkins run, you'll > see a link which takes you to an HTML generated document [3] which you > can review in lieu of the raw restructured text in gerrit. That will > actually generate all the specs in the repository, so you'll see the > "Example Spec" along with the Nuage one I used for reference here. > > Hope that helps! > Kyle > > [1] https://review.openstack.org/#/c/88069/ > [2] https://review.openstack.org/#/c/88690/ > [3] > http://docs-draft.openstack.org/90/88690/3/check/gate-neutron-specs-docs/fe4282a/doc/build/html/ > > > Thanks, > > > > > > On Sat, Apr 19, 2014 at 12:08 AM, Kyle Mestery < > mest...@noironetworks.com> > > wrote: > >> > >> Hi folks: > >> > >> I just wanted to let people know that we've merged a few patches [1] > >> to the neutron-specs repository over the past week which have > updated > >> the template.rst file. Specifically, Nachi has provided some > >> instructions for using Sphinx diagram tools in lieu of > asciiflow.com. > >> Either approach is fine for any Neutron BP submissions, but Nachi's > >> patch has some examples of using both approaches. Bob merged a patch > >> which shows an example of defining REST APIs with attribute tables. > >> > >> Just an update for anyone proposing BPs for Juno at the moment. > >> > >> Thanks! > >> Kyle > >> > >> [1] > >> > https://review.openstack.org/#/q/status:merged+project:openstack/neutron-specs,n,z > >> > >> ___ > >> OpenStack-dev mailing list > >> OpenStack-dev@lists.openstack.org > >> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev > > > > > > > > > > -- > > Mike Scherbakov > > #mihgen > > > > ___ > > OpenStack-dev mailing list > > OpenStack-dev@lists.openstack.org > > http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev > > > > ___ > OpenStack-dev mailing list > OpenStack-dev@lists.openstack.org > http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev > -- Mike Scherbakov #mihgen ___ OpenStack-dev mailing list OpenStack-dev@lists.openstack.org http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev >>> >>> _
Re: [openstack-dev] [neutron] Updates to the template for Neutron BPs
That's because spec was proposed to the juno/ folder. Look at https://raw.githubusercontent.com/openstack/neutron-specs/master/doc/source/index.rst, if spec is in juno/ folder, then contents shows it as approved one. Once merged, it means approved, right? So it is going to be Ok after merge. Though a better reminding than just "draft" in the url could be required if many start to mess it up... On Mon, Apr 21, 2014 at 10:43 AM, Kevin Benton wrote: > Yes. It shows up in the approved section since it's just a build of the > patch as-is. > > The link is titled gate-neutron-specs-docs in the message from Jenkins. > > -- > Kevin Benton > > > On Sun, Apr 20, 2014 at 11:37 PM, Mandeep Dhami > wrote: > >> Just for clarification. Jenkins link in the description puts the >> generated HTML in the section "Juno approved specs" even tho' the >> blueprint is still being reviewed. Am I looking at the right link? >> >> Regards, >> Mandeep >> >> >> On Sun, Apr 20, 2014 at 10:54 PM, Mike Scherbakov < >> mscherba...@mirantis.com> wrote: >> >>> Yes, thanks, that's exactly what I was looking for! >>> >>> >>> On Mon, Apr 21, 2014 at 12:03 AM, Kyle Mestery < >>> mest...@noironetworks.com> wrote: >>> On Sat, Apr 19, 2014 at 5:11 PM, Mike Scherbakov wrote: > Hi Kyle, > I built template and it looks awesome. We are considering to use same > approach for Fuel. > > My assumption is that spec will be on review for a negotiation time, which > is going to be quite a while. In my opinion, it is not always very > convenient to read spec in gerrit. > Agreed, though for some specs, this is actually an ok way to do reviews. > Did you guys have any thoughts on auto-build these specs into html on every > patch upload? So we could go somewhere and see built results, without a > requirement to fetch neutron-specs, and run tox? The possible drawback is > that reader won't see gerrit comments.. > I followed what Nova was going and committed code into openstack-infra/config which allows for some jenkins jobs to run when we commit to the neutron-specs gerrit. [1]. As an example, look at this commit here [2]. If you look at the latest Jenkins run, you'll see a link which takes you to an HTML generated document [3] which you can review in lieu of the raw restructured text in gerrit. That will actually generate all the specs in the repository, so you'll see the "Example Spec" along with the Nuage one I used for reference here. Hope that helps! Kyle [1] https://review.openstack.org/#/c/88069/ [2] https://review.openstack.org/#/c/88690/ [3] http://docs-draft.openstack.org/90/88690/3/check/gate-neutron-specs-docs/fe4282a/doc/build/html/ > Thanks, > > > On Sat, Apr 19, 2014 at 12:08 AM, Kyle Mestery < mest...@noironetworks.com> > wrote: >> >> Hi folks: >> >> I just wanted to let people know that we've merged a few patches [1] >> to the neutron-specs repository over the past week which have updated >> the template.rst file. Specifically, Nachi has provided some >> instructions for using Sphinx diagram tools in lieu of asciiflow.com . >> Either approach is fine for any Neutron BP submissions, but Nachi's >> patch has some examples of using both approaches. Bob merged a patch >> which shows an example of defining REST APIs with attribute tables. >> >> Just an update for anyone proposing BPs for Juno at the moment. >> >> Thanks! >> Kyle >> >> [1] >> https://review.openstack.org/#/q/status:merged+project:openstack/neutron-specs,n,z >> >> ___ >> OpenStack-dev mailing list >> OpenStack-dev@lists.openstack.org >> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev > > > > > -- > Mike Scherbakov > #mihgen > > ___ > OpenStack-dev mailing list > OpenStack-dev@lists.openstack.org > http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev > ___ OpenStack-dev mailing list OpenStack-dev@lists.openstack.org http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev >>> >>> >>> >>> -- >>> Mike Scherbakov >>> #mihgen >>> >>> ___ >>> OpenStack-dev mailing list >>> OpenStack-dev@lists.openstack.org >>> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev >>> >>> >> >> ___ >> OpenStack-dev mailing list >> OpenStack-dev@lists.openstack.org >> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev >> >> > > > -- > Kevin Benton > > __
Re: [openstack-dev] [neutron] Updates to the template for Neutron BPs
Yes. It shows up in the approved section since it's just a build of the patch as-is. The link is titled gate-neutron-specs-docs in the message from Jenkins. -- Kevin Benton On Sun, Apr 20, 2014 at 11:37 PM, Mandeep Dhami wrote: > Just for clarification. Jenkins link in the description puts the generated > HTML in the section "Juno approved specs" even tho' the blueprint is > still being reviewed. Am I looking at the right link? > > Regards, > Mandeep > > > On Sun, Apr 20, 2014 at 10:54 PM, Mike Scherbakov < > mscherba...@mirantis.com> wrote: > >> Yes, thanks, that's exactly what I was looking for! >> >> >> On Mon, Apr 21, 2014 at 12:03 AM, Kyle Mestery > > wrote: >> >>> On Sat, Apr 19, 2014 at 5:11 PM, Mike Scherbakov >>> wrote: >>> > Hi Kyle, >>> > I built template and it looks awesome. We are considering to use same >>> > approach for Fuel. >>> > >>> > My assumption is that spec will be on review for a negotiation time, >>> which >>> > is going to be quite a while. In my opinion, it is not always very >>> > convenient to read spec in gerrit. >>> > >>> Agreed, though for some specs, this is actually an ok way to do reviews. >>> >>> > Did you guys have any thoughts on auto-build these specs into html on >>> every >>> > patch upload? So we could go somewhere and see built results, without a >>> > requirement to fetch neutron-specs, and run tox? The possible drawback >>> is >>> > that reader won't see gerrit comments.. >>> > >>> I followed what Nova was going and committed code into >>> openstack-infra/config which allows for some jenkins jobs to run when >>> we commit to the neutron-specs gerrit. [1]. As an example, look at >>> this commit here [2]. If you look at the latest Jenkins run, you'll >>> see a link which takes you to an HTML generated document [3] which you >>> can review in lieu of the raw restructured text in gerrit. That will >>> actually generate all the specs in the repository, so you'll see the >>> "Example Spec" along with the Nuage one I used for reference here. >>> >>> Hope that helps! >>> Kyle >>> >>> [1] https://review.openstack.org/#/c/88069/ >>> [2] https://review.openstack.org/#/c/88690/ >>> [3] >>> http://docs-draft.openstack.org/90/88690/3/check/gate-neutron-specs-docs/fe4282a/doc/build/html/ >>> >>> > Thanks, >>> > >>> > >>> > On Sat, Apr 19, 2014 at 12:08 AM, Kyle Mestery < >>> mest...@noironetworks.com> >>> > wrote: >>> >> >>> >> Hi folks: >>> >> >>> >> I just wanted to let people know that we've merged a few patches [1] >>> >> to the neutron-specs repository over the past week which have updated >>> >> the template.rst file. Specifically, Nachi has provided some >>> >> instructions for using Sphinx diagram tools in lieu of asciiflow.com. >>> >> Either approach is fine for any Neutron BP submissions, but Nachi's >>> >> patch has some examples of using both approaches. Bob merged a patch >>> >> which shows an example of defining REST APIs with attribute tables. >>> >> >>> >> Just an update for anyone proposing BPs for Juno at the moment. >>> >> >>> >> Thanks! >>> >> Kyle >>> >> >>> >> [1] >>> >> >>> https://review.openstack.org/#/q/status:merged+project:openstack/neutron-specs,n,z >>> >> >>> >> ___ >>> >> OpenStack-dev mailing list >>> >> OpenStack-dev@lists.openstack.org >>> >> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev >>> > >>> > >>> > >>> > >>> > -- >>> > Mike Scherbakov >>> > #mihgen >>> > >>> > ___ >>> > OpenStack-dev mailing list >>> > OpenStack-dev@lists.openstack.org >>> > http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev >>> > >>> >>> ___ >>> OpenStack-dev mailing list >>> OpenStack-dev@lists.openstack.org >>> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev >>> >> >> >> >> -- >> Mike Scherbakov >> #mihgen >> >> ___ >> OpenStack-dev mailing list >> OpenStack-dev@lists.openstack.org >> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev >> >> > > ___ > OpenStack-dev mailing list > OpenStack-dev@lists.openstack.org > http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev > > -- Kevin Benton ___ OpenStack-dev mailing list OpenStack-dev@lists.openstack.org http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
Re: [openstack-dev] [neutron] Updates to the template for Neutron BPs
Just for clarification. Jenkins link in the description puts the generated HTML in the section "Juno approved specs" even tho' the blueprint is still being reviewed. Am I looking at the right link? Regards, Mandeep On Sun, Apr 20, 2014 at 10:54 PM, Mike Scherbakov wrote: > Yes, thanks, that's exactly what I was looking for! > > > On Mon, Apr 21, 2014 at 12:03 AM, Kyle Mestery > wrote: > >> On Sat, Apr 19, 2014 at 5:11 PM, Mike Scherbakov >> wrote: >> > Hi Kyle, >> > I built template and it looks awesome. We are considering to use same >> > approach for Fuel. >> > >> > My assumption is that spec will be on review for a negotiation time, >> which >> > is going to be quite a while. In my opinion, it is not always very >> > convenient to read spec in gerrit. >> > >> Agreed, though for some specs, this is actually an ok way to do reviews. >> >> > Did you guys have any thoughts on auto-build these specs into html on >> every >> > patch upload? So we could go somewhere and see built results, without a >> > requirement to fetch neutron-specs, and run tox? The possible drawback >> is >> > that reader won't see gerrit comments.. >> > >> I followed what Nova was going and committed code into >> openstack-infra/config which allows for some jenkins jobs to run when >> we commit to the neutron-specs gerrit. [1]. As an example, look at >> this commit here [2]. If you look at the latest Jenkins run, you'll >> see a link which takes you to an HTML generated document [3] which you >> can review in lieu of the raw restructured text in gerrit. That will >> actually generate all the specs in the repository, so you'll see the >> "Example Spec" along with the Nuage one I used for reference here. >> >> Hope that helps! >> Kyle >> >> [1] https://review.openstack.org/#/c/88069/ >> [2] https://review.openstack.org/#/c/88690/ >> [3] >> http://docs-draft.openstack.org/90/88690/3/check/gate-neutron-specs-docs/fe4282a/doc/build/html/ >> >> > Thanks, >> > >> > >> > On Sat, Apr 19, 2014 at 12:08 AM, Kyle Mestery < >> mest...@noironetworks.com> >> > wrote: >> >> >> >> Hi folks: >> >> >> >> I just wanted to let people know that we've merged a few patches [1] >> >> to the neutron-specs repository over the past week which have updated >> >> the template.rst file. Specifically, Nachi has provided some >> >> instructions for using Sphinx diagram tools in lieu of asciiflow.com. >> >> Either approach is fine for any Neutron BP submissions, but Nachi's >> >> patch has some examples of using both approaches. Bob merged a patch >> >> which shows an example of defining REST APIs with attribute tables. >> >> >> >> Just an update for anyone proposing BPs for Juno at the moment. >> >> >> >> Thanks! >> >> Kyle >> >> >> >> [1] >> >> >> https://review.openstack.org/#/q/status:merged+project:openstack/neutron-specs,n,z >> >> >> >> ___ >> >> OpenStack-dev mailing list >> >> OpenStack-dev@lists.openstack.org >> >> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev >> > >> > >> > >> > >> > -- >> > Mike Scherbakov >> > #mihgen >> > >> > ___ >> > OpenStack-dev mailing list >> > OpenStack-dev@lists.openstack.org >> > http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev >> > >> >> ___ >> OpenStack-dev mailing list >> OpenStack-dev@lists.openstack.org >> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev >> > > > > -- > Mike Scherbakov > #mihgen > > ___ > OpenStack-dev mailing list > OpenStack-dev@lists.openstack.org > http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev > > ___ OpenStack-dev mailing list OpenStack-dev@lists.openstack.org http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
Re: [openstack-dev] [neutron] Updates to the template for Neutron BPs
Yes, thanks, that's exactly what I was looking for! On Mon, Apr 21, 2014 at 12:03 AM, Kyle Mestery wrote: > On Sat, Apr 19, 2014 at 5:11 PM, Mike Scherbakov > wrote: > > Hi Kyle, > > I built template and it looks awesome. We are considering to use same > > approach for Fuel. > > > > My assumption is that spec will be on review for a negotiation time, > which > > is going to be quite a while. In my opinion, it is not always very > > convenient to read spec in gerrit. > > > Agreed, though for some specs, this is actually an ok way to do reviews. > > > Did you guys have any thoughts on auto-build these specs into html on > every > > patch upload? So we could go somewhere and see built results, without a > > requirement to fetch neutron-specs, and run tox? The possible drawback is > > that reader won't see gerrit comments.. > > > I followed what Nova was going and committed code into > openstack-infra/config which allows for some jenkins jobs to run when > we commit to the neutron-specs gerrit. [1]. As an example, look at > this commit here [2]. If you look at the latest Jenkins run, you'll > see a link which takes you to an HTML generated document [3] which you > can review in lieu of the raw restructured text in gerrit. That will > actually generate all the specs in the repository, so you'll see the > "Example Spec" along with the Nuage one I used for reference here. > > Hope that helps! > Kyle > > [1] https://review.openstack.org/#/c/88069/ > [2] https://review.openstack.org/#/c/88690/ > [3] > http://docs-draft.openstack.org/90/88690/3/check/gate-neutron-specs-docs/fe4282a/doc/build/html/ > > > Thanks, > > > > > > On Sat, Apr 19, 2014 at 12:08 AM, Kyle Mestery < > mest...@noironetworks.com> > > wrote: > >> > >> Hi folks: > >> > >> I just wanted to let people know that we've merged a few patches [1] > >> to the neutron-specs repository over the past week which have updated > >> the template.rst file. Specifically, Nachi has provided some > >> instructions for using Sphinx diagram tools in lieu of asciiflow.com. > >> Either approach is fine for any Neutron BP submissions, but Nachi's > >> patch has some examples of using both approaches. Bob merged a patch > >> which shows an example of defining REST APIs with attribute tables. > >> > >> Just an update for anyone proposing BPs for Juno at the moment. > >> > >> Thanks! > >> Kyle > >> > >> [1] > >> > https://review.openstack.org/#/q/status:merged+project:openstack/neutron-specs,n,z > >> > >> ___ > >> OpenStack-dev mailing list > >> OpenStack-dev@lists.openstack.org > >> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev > > > > > > > > > > -- > > Mike Scherbakov > > #mihgen > > > > ___ > > OpenStack-dev mailing list > > OpenStack-dev@lists.openstack.org > > http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev > > > > ___ > OpenStack-dev mailing list > OpenStack-dev@lists.openstack.org > http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev > -- Mike Scherbakov #mihgen ___ OpenStack-dev mailing list OpenStack-dev@lists.openstack.org http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
Re: [openstack-dev] [neutron] Updates to the template for Neutron BPs
On Sat, Apr 19, 2014 at 5:11 PM, Mike Scherbakov wrote: > Hi Kyle, > I built template and it looks awesome. We are considering to use same > approach for Fuel. > > My assumption is that spec will be on review for a negotiation time, which > is going to be quite a while. In my opinion, it is not always very > convenient to read spec in gerrit. > Agreed, though for some specs, this is actually an ok way to do reviews. > Did you guys have any thoughts on auto-build these specs into html on every > patch upload? So we could go somewhere and see built results, without a > requirement to fetch neutron-specs, and run tox? The possible drawback is > that reader won't see gerrit comments.. > I followed what Nova was going and committed code into openstack-infra/config which allows for some jenkins jobs to run when we commit to the neutron-specs gerrit. [1]. As an example, look at this commit here [2]. If you look at the latest Jenkins run, you'll see a link which takes you to an HTML generated document [3] which you can review in lieu of the raw restructured text in gerrit. That will actually generate all the specs in the repository, so you'll see the "Example Spec" along with the Nuage one I used for reference here. Hope that helps! Kyle [1] https://review.openstack.org/#/c/88069/ [2] https://review.openstack.org/#/c/88690/ [3] http://docs-draft.openstack.org/90/88690/3/check/gate-neutron-specs-docs/fe4282a/doc/build/html/ > Thanks, > > > On Sat, Apr 19, 2014 at 12:08 AM, Kyle Mestery > wrote: >> >> Hi folks: >> >> I just wanted to let people know that we've merged a few patches [1] >> to the neutron-specs repository over the past week which have updated >> the template.rst file. Specifically, Nachi has provided some >> instructions for using Sphinx diagram tools in lieu of asciiflow.com. >> Either approach is fine for any Neutron BP submissions, but Nachi's >> patch has some examples of using both approaches. Bob merged a patch >> which shows an example of defining REST APIs with attribute tables. >> >> Just an update for anyone proposing BPs for Juno at the moment. >> >> Thanks! >> Kyle >> >> [1] >> https://review.openstack.org/#/q/status:merged+project:openstack/neutron-specs,n,z >> >> ___ >> OpenStack-dev mailing list >> OpenStack-dev@lists.openstack.org >> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev > > > > > -- > Mike Scherbakov > #mihgen > > ___ > OpenStack-dev mailing list > OpenStack-dev@lists.openstack.org > http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev > ___ OpenStack-dev mailing list OpenStack-dev@lists.openstack.org http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
Re: [openstack-dev] [neutron] Updates to the template for Neutron BPs
Hi Kyle, I built template and it looks awesome. We are considering to use same approach for Fuel. My assumption is that spec will be on review for a negotiation time, which is going to be quite a while. In my opinion, it is not always very convenient to read spec in gerrit. Did you guys have any thoughts on auto-build these specs into html on every patch upload? So we could go somewhere and see built results, without a requirement to fetch neutron-specs, and run tox? The possible drawback is that reader won't see gerrit comments.. Thanks, On Sat, Apr 19, 2014 at 12:08 AM, Kyle Mestery wrote: > Hi folks: > > I just wanted to let people know that we've merged a few patches [1] > to the neutron-specs repository over the past week which have updated > the template.rst file. Specifically, Nachi has provided some > instructions for using Sphinx diagram tools in lieu of asciiflow.com. > Either approach is fine for any Neutron BP submissions, but Nachi's > patch has some examples of using both approaches. Bob merged a patch > which shows an example of defining REST APIs with attribute tables. > > Just an update for anyone proposing BPs for Juno at the moment. > > Thanks! > Kyle > > [1] > https://review.openstack.org/#/q/status:merged+project:openstack/neutron-specs,n,z > > ___ > OpenStack-dev mailing list > OpenStack-dev@lists.openstack.org > http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev > -- Mike Scherbakov #mihgen ___ OpenStack-dev mailing list OpenStack-dev@lists.openstack.org http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
[openstack-dev] [neutron] Updates to the template for Neutron BPs
Hi folks: I just wanted to let people know that we've merged a few patches [1] to the neutron-specs repository over the past week which have updated the template.rst file. Specifically, Nachi has provided some instructions for using Sphinx diagram tools in lieu of asciiflow.com. Either approach is fine for any Neutron BP submissions, but Nachi's patch has some examples of using both approaches. Bob merged a patch which shows an example of defining REST APIs with attribute tables. Just an update for anyone proposing BPs for Juno at the moment. Thanks! Kyle [1] https://review.openstack.org/#/q/status:merged+project:openstack/neutron-specs,n,z ___ OpenStack-dev mailing list OpenStack-dev@lists.openstack.org http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev