settingsLogin | Registersettings

[openstack-dev] [Docs] Changes for OpenStack API guides

+1 vote

Hello Anne,
I'm working on "moving to Keystone v3 API" spec for Neutron [1].
HenryG mentioned, that in next release or so, there will be change how to describe changes connected to API [2].
In spec I'm mentioning, that some changes are required to Networking API v2 [3], so would like to know, how it supposed to be handled.

If you could point me to some place where I can find extra info about changes, It would be very helpful.

Thanks,
Dariusz (dasm) Smigiel

[1] https://review.openstack.org/#/c/257362/
[2] http://lists.openstack.org/pipermail/openstack-dev/2016-January/083670.html
[3] http://developer.openstack.org/api-ref-networking-v2.html


OpenStack Development Mailing List (not for usage questions)
Unsubscribe: OpenStack-dev-request@lists.openstack.org?subject:unsubscribe
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
asked Feb 5, 2016 in openstack-dev by Smigiel,_Dariusz (770 points)   1 3
reshown Feb 5, 2016 by admin

2 Responses

0 votes

Hi --
Here's some specs for you to peruse to get a lot of background, and the
blog post and -dev mailing list post that went out. You can also ask me
directly, annegentle on IRC or through email. It's a lot and only two-three
people are working on this effort centrally with the rest of the work
across all projects.

http://lists.openstack.org/pipermail/openstack-dev/2016-January/083670.html
http://www.openstack.org/blog/2016/01/whats-next-for-application-developer-guides/

http://specs.openstack.org/openstack/docs-specs/specs/mitaka/app-guides-mitaka-vision.html
http://specs.openstack.org/openstack/docs-specs/specs/liberty/api-site.html

The latest progress is in these reviews:
Run a virtual server to serve REST API: https://review.openstack.org/276484
Build scripts to copy Swagger to developer.openstack.org:
https://review.openstack.org/#/c/269809/
Migration script to make Swagger from current WADL:
https://review.openstack.org/#/c/270819/

In January I sent emails directly to all the API liaisons from
http://specs.openstack.org/openstack/api-wg/liaisons.html so sounds like
the word is getting out! Thanks for asking.

Anne

On Fri, Feb 5, 2016 at 9:50 AM, Smigiel, Dariusz dariusz.smigiel@intel.com
wrote:

Hello Anne,

I’m working on “moving to Keystone v3 API” spec for Neutron [1].

HenryG mentioned, that in next release or so, there will be change how to
describe changes connected to API [2].

In spec I’m mentioning, that some changes are required to Networking API
v2 [3], so would like to know, how it supposed to be handled.

If you could point me to some place where I can find extra info about
changes, It would be very helpful.

Thanks,

Dariusz (dasm) Smigiel

[1] https://review.openstack.org/#/c/257362/

[2]
http://lists.openstack.org/pipermail/openstack-dev/2016-January/083670.html

[3] http://developer.openstack.org/api-ref-networking-v2.html

--
Anne Gentle
Rackspace
Principal Engineer
www.justwriteclick.com


OpenStack Development Mailing List (not for usage questions)
Unsubscribe: OpenStack-dev-request@lists.openstack.org?subject:unsubscribe
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
responded Feb 5, 2016 by annegentle_at_justwr (9,780 points)   2 5 6
0 votes

On Fri, Feb 5, 2016 at 9:50 AM, Smigiel, Dariusz dariusz.smigiel@intel.com
wrote:

Hello Anne,

I’m working on “moving to Keystone v3 API” spec for Neutron [1].

HenryG mentioned, that in next release or so, there will be change how to
describe changes connected to API [2].

In spec I’m mentioning, that some changes are required to Networking API
v2 [3], so would like to know, how it supposed to be handled.

If you could point me to some place where I can find extra info about
changes, It would be very helpful.

Also, for small feature changes happening now, it's fine to simply update
the WADL file as the migrations will be ongoing. You can find neutron API
reference information here:
https://github.com/openstack/api-site/tree/master/api-ref/src/wadls/networking-api/src/wadl

which is published to
http://developer.openstack.org/api-ref-networking-v2.html and will continue
to be while we work on changes away from WADL.
Thanks,
Anne

Thanks,

Dariusz (dasm) Smigiel

[1] https://review.openstack.org/#/c/257362/

[2]
http://lists.openstack.org/pipermail/openstack-dev/2016-January/083670.html

[3] http://developer.openstack.org/api-ref-networking-v2.html

--
Anne Gentle
Rackspace
Principal Engineer
www.justwriteclick.com


OpenStack Development Mailing List (not for usage questions)
Unsubscribe: OpenStack-dev-request@lists.openstack.org?subject:unsubscribe
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
responded Feb 5, 2016 by annegentle_at_justwr (9,780 points)   2 5 6
...