Open Stack

On Mon, Oct 29, 2012 at 9:04 AM, Sean Dague <sdague at linux.vnet.ibm.com> wrote:
> On 10/29/2012 09:40 AM, Anne Gentle wrote:
>>
>>
>> It would be extremely helpful for you to log doc bugs in
>> http://bugs.launchpad.net/openstack/api-site when you discover
>> out-dated information on api.openstack.org.
>
>
> On the API site, what's your current thinking on automatically keeping that
> in sync via the api-samples in tree? Would this be a good topic for the next
> doc team meeting?

Sure, great topic.

So far, the work done is:
- manually copy files from the nova repository api-samples folder into
the openstack-manuals repository
- point to the new api-samples in the relevant Core Compute-api WADL
- put in this patch: https://review.openstack.org/#/c/13201/

Then the work pattern is to propose patches for all the extension examples.
- manually copy files from the nova repository
- point to the new api-sample files in the relevant extension WADL
- put in this patch: https://review.openstack.org/#/c/14362/

The second work pattern needs to be repeated about 90 times to get all
the Extension examples updated. I talked about it in the Summit doc
session - would another discussion in the meeting help? Seems like we
just need more workers on the task than anything. Though I can
certainly do a detailed walkthrough for anyone who needs it.

I'd also like suggestions for automating the "manually copy files" step.

Thanks,
Anne


> I'd like to do the right thing in getting the work done in nova to sync to
> the api site with minimal manual intervention.
>
> Thanks,
>
>         -Sean
>
> --
> Sean Dague
> IBM Linux Technology Center
> email: sdague at linux.vnet.ibm.com
> alt-email: sldague at us.ibm.com
>
>
>
> _______________________________________________
> OpenStack-dev mailing list
> OpenStack-dev at lists.openstack.org
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev