Re: [openstack-dev] [api] [docs] Generating API samples

2015-08-25 Thread GHANSHYAM MANN
Hi Ken'ichi, Nice idea. On Wed, Aug 26, 2015 at 11:36 AM, Ken'ichi Ohmichi ken1ohmi...@gmail.com wrote: Hi Anne, Nova API guys, I'd like to explain how to generate API docs from Tempest log. In Tempest, each API test contains UUID for the test identification now. Current my idea is to parse

Re: [openstack-dev] [api] [docs] Generating API samples

2015-08-25 Thread Ken'ichi Ohmichi
Hi Anne, Nova API guys, I'd like to explain how to generate API docs from Tempest log. In Tempest, each API test contains UUID for the test identification now. Current my idea is to parse tempest log, create a patch based on the parsing and post a patch to each project repo like: 1. Each

Re: [openstack-dev] [api] [docs] Generating API samples

2015-08-25 Thread Ken'ichi Ohmichi
2015-08-26 12:15 GMT+09:00 GHANSHYAM MANN ghanshyamm...@gmail.com: Hi Ken'ichi, Nice idea. On Wed, Aug 26, 2015 at 11:36 AM, Ken'ichi Ohmichi ken1ohmi...@gmail.com wrote: Hi Anne, Nova API guys, I'd like to explain how to generate API docs from Tempest log. In Tempest, each API test

Re: [openstack-dev] [api] [docs] Generating API samples

2015-08-25 Thread michael mccune
On 08/24/2015 11:51 AM, Anne Gentle wrote: Hi all, I'm writing to find out how teams keep API sample requests and responses up-to-date. I know the nova team has a sample generator [1] that they've maintained for a few years now. Do other teams have something similar? If so, is your approach

Re: [openstack-dev] [api] [docs] Generating API samples

2015-08-25 Thread Ken'ichi Ohmichi
Hi Anne, 2015-08-25 0:51 GMT+09:00 Anne Gentle annegen...@justwriteclick.com: Hi all, I'm writing to find out how teams keep API sample requests and responses up-to-date. I know the nova team has a sample generator [1] that they've maintained for a few years now. Do other teams have

Re: [openstack-dev] [api] [docs] Generating API samples

2015-08-24 Thread Morgan Fainberg
Keystone doesn't use anything similar to sample requests at this time. Though I am sure there wouldn't be much opposition to it provided there was someone stepping up to do the work. Sent via mobile On Aug 24, 2015, at 08:51, Anne Gentle annegen...@justwriteclick.com wrote: Hi all,

[openstack-dev] [api] [docs] Generating API samples

2015-08-24 Thread Anne Gentle
Hi all, I'm writing to find out how teams keep API sample requests and responses up-to-date. I know the nova team has a sample generator [1] that they've maintained for a few years now. Do other teams have something similar? If so, is your approach like the nova one? Thanks, Anne 1.