On Fri, Apr 15, 2016 at 12:04 PM, Sean McGinnis <sean.mcgin...@gmx.com> wrote:
> On Fri, Apr 15, 2016 at 11:17:40AM -0500, Anne Gentle wrote: > > Sean and I are collaborating on a cross project spec to talk about at > the Summit. Can you talk about concerns or cons to this approach so we can > put it in the spec? > > > > Thanks, > > Anne > > Thanks Anne. No concerns at the moment. I was just afraid I had missed > something from the discussions. > Okay, good. My sense is that this project ownership of API docs is a great direction. > > Thanks for the clarification. I will watch for the cross project > session. > Here's the one you want. https://www.openstack.org/summit/austin-2016/summit-schedule/events/9479 Thanks - Anne > > Thanks! > Sean > > > > > > > > On Apr 15, 2016, at 11:02 AM, Sean McGinnis <sean.mcgin...@gmx.com> > wrote: > > > > > >> On Fri, Apr 15, 2016 at 09:38:20AM +0200, Andreas Jaeger wrote: > > >>> On 04/15/2016 08:14 AM, Masahito MUROI wrote: > > >>> Hi Doc team folks, > > >>> > > >>> Congress team plans to add API reference into [1] instead of [2] to > > >>> follow official documentation project. But I found the design session > > >>> about a API docs style[3]. > > >>> > > >>> For now, is it ok to add API reference [1], or should we wait the > > >>> decision about style of API reference repository? > > >>> > > >>> 1. http://developer.openstack.org/api-ref.html > > >>> 2. http://docs.openstack.org/developer/congress/ > > >>> 3. > > >>> > https://www.openstack.org/summit/austin-2016/summit-schedule/events/9479?goback=1 > > >> > > >> > > >> See the work that is done by Sean Dague and Anne Gentle for nova and > > >> follow this setup: > > >> > http://lists.openstack.org/pipermail/openstack-dev/2016-April/092234.html > > > > > > I thought I followed all of the emails on moving to Swagger then RST. > > > Moving the api docs in tree with the projects is something I wasn't > > > aware of. > > > > > > Was there a cross-project spec for this or something detailing the long > > > term goal and direction each team should take for doing this? I see the > > > work Nova has done (looks great) but is that something that team has > > > decided to explore or is this something all of us should be involved > in? > > > > > > Sorry, just caught a little off guard here and trying to figure out > what > > > I've missed. > > > > > > Sean > > > > > >> > > >> There have been a couple more emails in the last months on this topic > > >> > > >> Also, there's a spec: > > >> > http://specs.openstack.org/openstack/docs-specs/specs/mitaka/app-guides-mitaka-vision.html > > >> > > >> so, you should do this in your own repository, set up proper jobs - > > >> and then publish to developer.openstack.org > > > > > > That spec doesn't say anything about moving to each project's > > > repository. Is there something else with more detail? > > > > > >> > > >> Andreas > > >> -- > > >> Andreas Jaeger aj@{suse.com,opensuse.org} Twitter/Identica: > jaegerandi > > >> SUSE LINUX GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany > > >> GF: Felix Imendörffer, Jane Smithard, Graham Norton, > > >> HRB 21284 (AG Nürnberg) > > >> GPG fingerprint = 93A3 365E CE47 B889 DF7F FED1 389A 563C C272 > A126 > > >> > > >> > > >> > __________________________________________________________________________ > > >> OpenStack Development Mailing List (not for usage questions) > > >> Unsubscribe: > openstack-dev-requ...@lists.openstack.org?subject:unsubscribe > > >> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev > > > > > > > __________________________________________________________________________ > > > OpenStack Development Mailing List (not for usage questions) > > > Unsubscribe: > openstack-dev-requ...@lists.openstack.org?subject:unsubscribe > > > http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev > > > > > __________________________________________________________________________ > > OpenStack Development Mailing List (not for usage questions) > > Unsubscribe: > openstack-dev-requ...@lists.openstack.org?subject:unsubscribe > > http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev > > __________________________________________________________________________ > OpenStack Development Mailing List (not for usage questions) > Unsubscribe: openstack-dev-requ...@lists.openstack.org?subject:unsubscribe > http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev > -- Anne Gentle www.justwriteclick.com
__________________________________________________________________________ OpenStack Development Mailing List (not for usage questions) Unsubscribe: openstack-dev-requ...@lists.openstack.org?subject:unsubscribe http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev