Hi folks,

Anne's suggestion is to have Quantum follow the other OpenStack projects and
have our API docs in a separate repo.  This has the benefit of keeping the
large docbook diffs out of the main repo, but has the downside that it may
be harder to enforce that code & API docs are in sync.

Unless someone has concerns here, we'll follow the standard path.

Anne, I assume that the same core team is responsible for approving changes
to the API docs?

Dan


On Wed, Sep 14, 2011 at 10:20 AM, Dan Wendlandt <d...@nicira.com> wrote:

> All major openstack projects seem to be heading in the direction of keeping
> their API documentation in a separate repo.
>
> Salvatore, what are your thoughts on taking this approach with Quantum?
>  Any one else see pluses or minus, other than the obvious benefit of mapping
> to what other OpenStack projects are doing?
>
> My assumption is that the api repo is managed by the core team, just like
> the main code repo.
>
> Dan
>
> ---------- Forwarded message ----------
> From: Anne Gentle <a...@openstack.org>
> Date: Wed, Sep 14, 2011 at 9:45 AM
> Subject: [Openstack] Compute API and doc
> To: openst...@lists.launchpad.net
>
>
> Hi all -
>
> The move to Github for the Compute API is now complete and the 1.1 API
> spec, the 1.0 API doc, and the API Extension proposal now live in this
> repository:
>
> https://github.com/openstack/compute-api
>
> There's also a new Jenkins job that builds the documents to
> docs.openstack.org/trunk out of this repo.
>
> Next I'll move the rest of the books out of the Launchpad openstack-manuals
> repository, though you can continue to log doc bugs in Launchpad at
> http://bugs.launchpad.net/openstack-manuals.
>
> Thanks for hanging in there through the transition.
>
> Anne
>
> *Anne Gentle*
> a...@openstack.org
>  my blog <http://justwriteclick.com/> | my 
> book<http://xmlpress.net/publications/conversation-community/>|
> LinkedIn <http://www.linkedin.com/in/annegentle> | 
> Delicious<http://del.icio.us/annegentle>|
> Twitter <http://twitter.com/annegentle>
>
> _______________________________________________
> Mailing list: https://launchpad.net/~openstack
> Post to     : openst...@lists.launchpad.net
> Unsubscribe : https://launchpad.net/~openstack
> More help   : https://help.launchpad.net/ListHelp
>
>
>
>
> --
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~
> Dan Wendlandt
> Nicira Networks, Inc.
> www.nicira.com | www.openvswitch.org
> Sr. Product Manager
> cell: 650-906-2650
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
>


-- 
~~~~~~~~~~~~~~~~~~~~~~~~~~~
Dan Wendlandt
Nicira Networks, Inc.
www.nicira.com | www.openvswitch.org
Sr. Product Manager
cell: 650-906-2650
~~~~~~~~~~~~~~~~~~~~~~~~~~~
-- 
Mailing list: https://launchpad.net/~netstack
Post to     : netstack@lists.launchpad.net
Unsubscribe : https://launchpad.net/~netstack
More help   : https://help.launchpad.net/ListHelp

Reply via email to