<html xmlns:v="urn:schemas-microsoft-com:vml" xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" xmlns="http://www.w3.org/TR/REC-html40">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta name="Generator" content="Microsoft Word 15 (filtered medium)">
<style><!--
/* Font Definitions */
@font-face
{font-family:"MS Gothic";
panose-1:2 11 6 9 7 2 5 8 2 4;}
@font-face
{font-family:"Cambria Math";
panose-1:2 4 5 3 5 4 6 3 2 4;}
@font-face
{font-family:Calibri;
panose-1:2 15 5 2 2 2 4 3 2 4;}
@font-face
{font-family:"\@MS Gothic";
panose-1:2 11 6 9 7 2 5 8 2 4;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
{margin:0in;
margin-bottom:.0001pt;
font-size:12.0pt;
font-family:"Times New Roman",serif;}
a:link, span.MsoHyperlink
{mso-style-priority:99;
color:blue;
text-decoration:underline;}
a:visited, span.MsoHyperlinkFollowed
{mso-style-priority:99;
color:purple;
text-decoration:underline;}
span.EmailStyle17
{mso-style-type:personal-reply;
font-family:"Calibri",sans-serif;
color:#1F497D;}
.MsoChpDefault
{mso-style-type:export-only;
font-family:"Calibri",sans-serif;}
@page WordSection1
{size:8.5in 11.0in;
margin:1.0in 1.0in 1.0in 1.0in;}
div.WordSection1
{page:WordSection1;}
--></style><!--[if gte mso 9]><xml>
<o:shapedefaults v:ext="edit" spidmax="1026" />
</xml><![endif]--><!--[if gte mso 9]><xml>
<o:shapelayout v:ext="edit">
<o:idmap v:ext="edit" data="1" />
</o:shapelayout></xml><![endif]-->
</head>
<body lang="EN-US" link="blue" vlink="purple">
<div class="WordSection1">
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D">Hi,<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D">The works in Magnum api-ref can be reviewed at [1]. Please take a look and get these to be merged ASAP.<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D">[1].
<a href="https://blueprints.launchpad.net/magnum/+spec/magnum-doc-rest-api">https://blueprints.launchpad.net/magnum/+spec/magnum-doc-rest-api</a><o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D">Thanks,<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D">Hieu LE.<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D"><o:p> </o:p></span></p>
<p class="MsoNormal"><b><span style="font-size:11.0pt;font-family:"Calibri",sans-serif">From:</span></b><span style="font-size:11.0pt;font-family:"Calibri",sans-serif"> Anne Gentle [mailto:annegentle@justwriteclick.com]
<br>
<b>Sent:</b> Sunday, August 21, 2016 8:20 AM<br>
<b>To:</b> Shuu Mutou <shu-mutou@rf.jp.nec.com><br>
<b>Cc:</b> msm@redhat.com; Haruhiko Katou <har-katou@ts.jp.nec.com>; openstack-dev@lists.openstack.org; openstack-docs@lists.openstack.org; Kenichi.Omichi@necam.com<br>
<b>Subject:</b> Re: [openstack-dev] [OpenStack-docs] [Magnum] Using common tooling for API docs<o:p></o:p></span></p>
<p class="MsoNormal"><o:p> </o:p></p>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
<div>
<p class="MsoNormal">On Fri, Aug 19, 2016 at 2:27 AM, Shuu Mutou <<a href="mailto:shu-mutou@rf.jp.nec.com" target="_blank">shu-mutou@rf.jp.nec.com</a>> wrote:<o:p></o:p></p>
<blockquote style="border:none;border-left:solid #CCCCCC 1.0pt;padding:0in 0in 0in 6.0pt;margin-left:4.8pt;margin-right:0in">
<p class="MsoNormal" style="margin-bottom:12.0pt">> AFAIK, the API WG adopted Swagger (OpenAPI) as common tool for API<br>
> docs.<br>
> Anne, has not the adoption been changed? Otherwise, do we need to<br>
> maintain much RST files also?<br>
><br>
><br>
><br>
> It does say either/or in the API WG guideline:<br>
> <a href="http://specs.openstack.org/openstack/api-wg/guidelines/api-docs.html" target="_blank">
http://specs.openstack.org/openstack/api-wg/guidelines/api-docs.html</a><br>
<br>
Yes. Also Ken'ichi Omichi said.<br>
<br>
<br>
> This isn't about a contest between projects for the best approach. This<br>
> is about serving end-users the best information we can.<br>
<br>
Yes. Correct information is the best information. The Accuracy is more important than web experience. When I was a user (and SIer), the document accuracy had not been kept. So we had to read source code at last. And now, as a developer (mainly UI plugins),
I don't want maintain overlapped content several times (API source code, API reference, helps in client, helps in WebUI, etc). So I spend efforts to the spec auto-generation.<br>
<br>
<br>
> I'm reporting what I'm seeing from a broader viewpoint than a single project.<br>
> I don't have a solution other than RST/YAML for common navigation, and I'm<br>
> asking you to provide ideas for that integration point.<br>
><br>
> My vision is that even if you choose to publish with OpenAPI, you would<br>
> find a way to make this web experience better. We can do better than this<br>
> scattered approach. I'm asking you to find a way to unify and consider the<br>
> web experience of a consumer of OpenStack services. Can you generate HTML<br>
> that can plug into the openstackdocstheme we are providing as a common tool?<br>
<br>
I need to know about the "common tools". Please, let me know what is difference between HTMLs built by Lars's patch and by common tools? Or can fairy-slipper do that from OpenAPI file?<o:p></o:p></p>
</blockquote>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">Sure, sounds like there's some info missing that I can clarify. <o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">All HTML built for OpenStack sites are copied via FTP. There's no difference except for the CSS and JavaScript provided by openstackdocstheme and built by os-api-ref. <o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">Fairy-slipper is no longer being worked on as a common solution to serving all OpenStack API information. It was used for migration purposes.<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">Lars's patch could find a way to use the CSS and JS to create a seamless experience for end-users. <o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">Anne<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal"> <o:p></o:p></p>
</div>
<blockquote style="border:none;border-left:solid #CCCCCC 1.0pt;padding:0in 0in 0in 6.0pt;margin-left:4.8pt;margin-right:0in">
<p class="MsoNormal"><br>
Thanks,<br>
Shu<br>
<br>
<br>
> -----Original Message-----<br>
> From: Anne Gentle [mailto:<a href="mailto:annegentle@justwriteclick.com">annegentle@justwriteclick.com</a>]<br>
> Sent: Wednesday, August 17, 2016 11:55 AM<br>
> To: Mutou Shuu(<span style="font-family:"Calibri",sans-serif">武藤</span> <span style="font-family:"Calibri",sans-serif">
周</span>) <<a href="mailto:shu-mutou@rf.jp.nec.com">shu-mutou@rf.jp.nec.com</a>><br>
> Cc: <a href="mailto:openstack-dev@lists.openstack.org">openstack-dev@lists.openstack.org</a>;
<a href="mailto:msm@redhat.com">msm@redhat.com</a>; Katou Haruhiko(<span style="font-family:"Calibri",sans-serif">加</span><br>
> <span style="font-family:"Calibri",sans-serif">藤</span> <span style="font-family:"Calibri",sans-serif">
治彦</span>) <<a href="mailto:har-katou@ts.jp.nec.com">har-katou@ts.jp.nec.com</a>>;
<a href="mailto:openstack-docs@lists.openstack.org">openstack-docs@lists.openstack.org</a>;<br>
> <a href="mailto:Kenichi.Omichi@necam.com">Kenichi.Omichi@necam.com</a><br>
> Subject: Re: [OpenStack-docs] [openstack-dev] [Magnum] Using common<br>
> tooling for API docs<br>
><br>
><br>
><br>
> On Tue, Aug 16, 2016 at 1:05 AM, Shuu Mutou <<a href="mailto:shu-mutou@rf.jp.nec.com">shu-mutou@rf.jp.nec.com</a><o:p></o:p></p>
<div>
<div>
<p class="MsoNormal">> <mailto:<a href="mailto:shu-mutou@rf.jp.nec.com">shu-mutou@rf.jp.nec.com</a>> > wrote:<br>
><br>
><br>
> Hi Anne,<br>
><br>
> AFAIK, the API WG adopted Swagger (OpenAPI) as common tool for API<br>
> docs.<br>
> Anne, has not the adoption been changed? Otherwise, do we need to<br>
> maintain much RST files also?<br>
><br>
><br>
><br>
> It does say either/or in the API WG guideline:<br>
> <a href="http://specs.openstack.org/openstack/api-wg/guidelines/api-docs.html" target="_blank">
http://specs.openstack.org/openstack/api-wg/guidelines/api-docs.html</a><br>
><br>
><br>
><br>
> IMO, for that the reference and the source code doesn't have<br>
> conflict, these should be near each other as possible as follow. And it<br>
> decreases maintainance costs for documents, and increases document<br>
> reliability. So I believe our approach is more ideal.<br>
><br>
><br>
><br>
><br>
> This isn't about a contest between projects for the best approach. This<br>
> is about serving end-users the best information we can.<br>
><br>
><br>
> The Best: the references generated from source code.<br>
><br>
><br>
><br>
> I don't want to argue, but anything generated from the source code suffers<br>
> if the source code changes in a way that reviewers don't catch as a<br>
> backwards-incompatible change you can break your contract.<br>
><br>
><br>
> Better: the references written in docstring.<br>
><br>
> We know some projects abandoned these approach, and then they uses<br>
> RST + YAML.<br>
> But we hope decreasing maintainance cost for the documents. So we<br>
> should not create so much RST files, I think.<br>
><br>
><br>
><br>
><br>
> I think you'll see the evolution of our discussions over the years has<br>
> brought us to this point in time. Yes, there are trade-offs in these<br>
> decisions.<br>
><br>
><br>
><br>
> I'm proceeding auto-generation of swagger spec from magnum source<br>
> code using pecan-swagger [1], and improving pecan-swagger with Michael<br>
> McCune [2].<br>
> These will generate almost Magnum API specs automatically in<br>
> OpenAPI format.<br>
> Also, these approach can be adopted by other APIs that uses pecan<br>
> and WSME.<br>
> Please check this also.<br>
><br>
><br>
><br>
> I ask you to consider the experience of someone consuming the API documents<br>
> OpenStack provides. There are 26 REST API services under an OpenStack<br>
> umbrella. Twelve of them will be included in an unified side-bar navigation<o:p></o:p></p>
</div>
</div>
<p class="MsoNormal">> on <a href="http://developer.openstack.org" target="_blank">
developer.openstack.org</a> <<a href="http://developer.openstack.org" target="_blank">http://developer.openstack.org</a>> due to<o:p></o:p></p>
<div>
<div>
<p class="MsoNormal">> using Sphinx tooling provided as a common web experience. Six of them don't<br>
> have redirects yet from the "old way" to do API reference docs. Seven of<br>
> them are not collected under a single landing page or common sidebar or<br>
> navigation. Three of them have no API docs published to a website.<br>
><br>
> I'm reporting what I'm seeing from a broader viewpoint than a single project.<br>
> I don't have a solution other than RST/YAML for common navigation, and I'm<br>
> asking you to provide ideas for that integration point.<br>
><br>
> My vision is that even if you choose to publish with OpenAPI, you would<br>
> find a way to make this web experience better. We can do better than this<br>
> scattered approach. I'm asking you to find a way to unify and consider the<br>
> web experience of a consumer of OpenStack services. Can you generate HTML<br>
> that can plug into the openstackdocstheme we are providing as a common tool?<br>
> Thanks,<br>
> Anne<br>
><br>
><br>
><br>
> [1] <a href="https://review.openstack.org/#/c/303235/" target="_blank">https://review.openstack.org/#/c/303235/</a><br>
> <<a href="https://review.openstack.org/#/c/303235/" target="_blank">https://review.openstack.org/#/c/303235/</a>><br>
> [2] <a href="https://github.com/elmiko/pecan-swagger/" target="_blank">https://github.com/elmiko/pecan-swagger/</a><br>
> <<a href="https://github.com/elmiko/pecan-swagger/" target="_blank">https://github.com/elmiko/pecan-swagger/</a>><br>
><br>
> Regards,<br>
> Shu<br>
><br>
><br>
> > -----Original Message-----<br>
> > From: Anne Gentle [mailto:<a href="mailto:annegentle@justwriteclick.com">annegentle@justwriteclick.com</a><br>
> <mailto:<a href="mailto:annegentle@justwriteclick.com">annegentle@justwriteclick.com</a>> ]<br>
> > Sent: Monday, August 15, 2016 11:00 AM<br>
> > To: Hongbin Lu <<a href="mailto:hongbin.lu@huawei.com">hongbin.lu@huawei.com</a><o:p></o:p></p>
</div>
</div>
<p class="MsoNormal">> <mailto:<a href="mailto:hongbin.lu@huawei.com">hongbin.lu@huawei.com</a>> ><br>
> > Cc: <a href="mailto:openstack-dev@lists.openstack.org">openstack-dev@lists.openstack.org</a><br>
> <mailto:<a href="mailto:openstack-dev@lists.openstack.org">openstack-dev@lists.openstack.org</a>> ;
<a href="http://enstack.org" target="_blank">enstack.org</a><br>
> <<a href="http://enstack.org" target="_blank">http://enstack.org</a>><br>
> > <<a href="mailto:openstack-docs@lists.openstack.org">openstack-docs@lists.openstack.org</a><br>
> <mailto:<a href="mailto:openstack-docs@lists.openstack.org">openstack-docs@lists.openstack.org</a>> ><o:p></o:p></p>
<div>
<div>
<p class="MsoNormal">> > Subject: Re: [openstack-dev] [OpenStack-docs] [Magnum] Using<br>
> common<br>
> > tooling for API docs<br>
> ><br>
> > Hi Hongbin,<br>
> ><br>
> > Thanks for asking. I'd like for teams to look for ways to innovate<br>
> and<br>
> > integrate with the navigation as a good entry point for OpenAPI<br>
> to become<br>
> > a standard for OpenStack to use. That said, we have to move forward<br>
> and<br>
> > make progress.<br>
> ><br>
> > Is Lars or anyone on the Magnum team interested in the web<br>
> development work<br>
> > to integrate with the sidebar? See the work at<br>
> > <a href="https://review.openstack.org/#/c/329508" target="_blank">https://review.openstack.org/#/c/329508</a><br>
> <<a href="https://review.openstack.org/#/c/329508" target="_blank">https://review.openstack.org/#/c/329508</a>> and my comments on<br>
> > <a href="https://review.openstack.org/#/c/351800/" target="_blank">https://review.openstack.org/#/c/351800/</a><br>
> <<a href="https://review.openstack.org/#/c/351800/" target="_blank">https://review.openstack.org/#/c/351800/</a>> saying that I would like<br>
> teams<br>
> > to integrate first to provide the best web experience for people<br>
> consuming<br>
> > the docs.<br>
> ><br>
> > Anne<br>
> ><br>
> > On Fri, Aug 12, 2016 at 4:43 PM, Hongbin Lu <<a href="mailto:hongbin.lu@huawei.com">hongbin.lu@huawei.com</a><br>
> <mailto:<a href="mailto:hongbin.lu@huawei.com">hongbin.lu@huawei.com</a>><o:p></o:p></p>
</div>
</div>
<p class="MsoNormal">> > <mailto:<a href="mailto:hongbin.lu@huawei.com">hongbin.lu@huawei.com</a> <mailto:<a href="mailto:hongbin.lu@huawei.com">hongbin.lu@huawei.com</a>> ><o:p></o:p></p>
<div>
<div>
<p class="MsoNormal">> > wrote:<br>
> ><br>
> ><br>
> > Hi team,<br>
> ><br>
> ><br>
> ><br>
> > As mentioned in the email below, Magnum are not using common<br>
> tooling<br>
> > for generating API docs, so we are excluded from the common<br>
> navigation of<br>
> > OpenStack API. I think we need to prioritize the work to fix it.<br>
> BTW, I<br>
> > notice there is a WIP patch [1] for generating API docs by using<br>
> Swagger.<br>
> > However, I am not sure if Swagger belongs to “common tooling”<br>
> (docs team,<br>
> > please confirm).<br>
> ><br>
> ><br>
> ><br>
> > [1] <a href="https://review.openstack.org/#/c/317368/" target="_blank">
https://review.openstack.org/#/c/317368/</a><br>
> <<a href="https://review.openstack.org/#/c/317368/" target="_blank">https://review.openstack.org/#/c/317368/</a>><br>
> > <<a href="https://review.openstack.org/#/c/317368/" target="_blank">https://review.openstack.org/#/c/317368/</a><br>
> <<a href="https://review.openstack.org/#/c/317368/" target="_blank">https://review.openstack.org/#/c/317368/</a>> ><br>
> ><br>
> ><br>
> ><br>
> > Best regards,<br>
> ><br>
> > Hongbin<br>
> ><br>
> ><br>
> ><br>
> > From: Anne Gentle [mailto:<a href="mailto:annegentle@justwriteclick.com">annegentle@justwriteclick.com</a><br>
> <mailto:<a href="mailto:annegentle@justwriteclick.com">annegentle@justwriteclick.com</a>><br>
> > <mailto:<a href="mailto:annegentle@justwriteclick.com">annegentle@justwriteclick.com</a><br>
> <mailto:<a href="mailto:annegentle@justwriteclick.com">annegentle@justwriteclick.com</a>> > ]<br>
> > Sent: August-10-16 3:50 PM<br>
> > To: OpenStack Development Mailing List;<br>
> > <a href="mailto:openstack-docs@lists.openstack.org">openstack-docs@lists.openstack.org</a><br>
> <mailto:<a href="mailto:openstack-docs@lists.openstack.org">openstack-docs@lists.openstack.org</a>><o:p></o:p></p>
</div>
</div>
<p class="MsoNormal">> > <mailto:<a href="mailto:openstack-docs@lists.openstack.org">openstack-docs@lists.openstack.org</a><br>
> <mailto:<a href="mailto:openstack-docs@lists.openstack.org">openstack-docs@lists.openstack.org</a>> ><br>
> > Subject: [openstack-dev] [api] [doc] API status report<br>
> ><br>
> ><br>
> ><br>
> > Hi all,<br>
> ><br>
> > I wanted to report on status and answer any questions you<br>
> all have<br>
> > about the API reference and guide publishing process.<br>
> ><br>
> ><br>
> ><br>
> > The expectation is that we provide all OpenStack API<br>
> information<br>
> > on <a href="http://developer.openstack.org" target="_blank">developer.openstack.org</a> <<a href="http://developer.openstack.org" target="_blank">http://developer.openstack.org</a>><br>
> <<a href="http://developer.openstack.org" target="_blank">http://developer.openstack.org</a> <<a href="http://developer.openstack.org" target="_blank">http://developer.openstack.org</a>> > . In<o:p></o:p></p>
<div>
<div>
<p class="MsoNormal">> order to<br>
> > meet that goal, it's simplest for now to have all projects use<br>
> the<br>
> > RST+YAML+openstackdocstheme+os-api-ref extension tooling so<br>
> that users<br>
> > see available OpenStack APIs in a sidebar navigation drop-down<br>
> list.<br>
> ><br>
> ><br>
> ><br>
> > --Migration--<br>
> ><br>
> > The current status for migration is that all WADL content<br>
> is<br>
> > migrated except for trove. There is a patch in progress and I'm<br>
> in contact<br>
> > with the team to assist in any way.<br>
> > <a href="https://review.openstack.org/#/c/316381/" target="_blank">https://review.openstack.org/#/c/316381/</a><br>
> <<a href="https://review.openstack.org/#/c/316381/" target="_blank">https://review.openstack.org/#/c/316381/</a>><br>
> > <<a href="https://review.openstack.org/#/c/316381/" target="_blank">https://review.openstack.org/#/c/316381/</a><br>
> <<a href="https://review.openstack.org/#/c/316381/" target="_blank">https://review.openstack.org/#/c/316381/</a>> ><br>
> ><br>
> ><br>
> ><br>
> > --Theme, extension, release requirements--<br>
> ><br>
> > The current status for the theme, navigation, and Sphinx<br>
> extension<br>
> > tooling is contained in the latest post from Graham proposing<br>
> a solution<br>
> > for the release number switchover and offers to help teams as<br>
> needed:<br>
> ><br>
> <a href="http://lists.openstack.org/pipermail/openstack-dev/2016-August/101112" target="_blank">
http://lists.openstack.org/pipermail/openstack-dev/2016-August/101112</a><o:p></o:p></p>
</div>
</div>
<p class="MsoNormal">> <<a href="http://lists.openstack.org/pipermail/openstack-dev/2016-August/101112" target="_blank">http://lists.openstack.org/pipermail/openstack-dev/2016-August/101112</a><br>
> > .<br>
> > html<br>
> ><br>
> <<a href="http://lists.openstack.org/pipermail/openstack-dev/2016-August/101112" target="_blank">http://lists.openstack.org/pipermail/openstack-dev/2016-August/101112</a><o:p></o:p></p>
<div>
<div>
<p class="MsoNormal">> <<a href="http://lists.openstack.org/pipermail/openstack-dev/2016-August/101112" target="_blank">http://lists.openstack.org/pipermail/openstack-dev/2016-August/101112</a><br>
> ><br>
> > .html> I hope to meet the requirements deadline to get those<br>
> changes landed.<br>
><br>
> > Requirements freeze is Aug 29.<br>
> ><br>
> ><br>
> ><br>
> > --Project coverage--<br>
> ><br>
> > The current status for project coverage is that these<br>
> projects are<br>
> > now using the RST+YAML in-tree workflow and tools and publishing<br>
> to<br>
> > <a href="http://developer.openstack.org/api-ref/" target="_blank">http://developer.openstack.org/api-ref/</a><br>
> <<a href="http://developer.openstack.org/api-ref/" target="_blank">http://developer.openstack.org/api-ref/</a>><br>
> > <<a href="http://developer.openstack.org/api-ref/" target="_blank">http://developer.openstack.org/api-ref/</a><br>
> <<a href="http://developer.openstack.org/api-ref/" target="_blank">http://developer.openstack.org/api-ref/</a>> > <servicename> so they will be<br>
> > included in the upcoming API navigation sidebar intended to span<br>
> all<br>
> > OpenStack APIs:<br>
> ><br>
> ><br>
> ><br>
> > designate <a href="http://developer.openstack.org/api-ref/dns/" target="_blank">
http://developer.openstack.org/api-ref/dns/</a><br>
> <<a href="http://developer.openstack.org/api-ref/dns/" target="_blank">http://developer.openstack.org/api-ref/dns/</a>><br>
> > <<a href="http://developer.openstack.org/api-ref/dns/" target="_blank">http://developer.openstack.org/api-ref/dns/</a><br>
> <<a href="http://developer.openstack.org/api-ref/dns/" target="_blank">http://developer.openstack.org/api-ref/dns/</a>> ><br>
> ><br>
> > glance <a href="http://developer.openstack.org/api-ref/image/" target="_blank">
http://developer.openstack.org/api-ref/image/</a><br>
> <<a href="http://developer.openstack.org/api-ref/image/" target="_blank">http://developer.openstack.org/api-ref/image/</a>><br>
> > <<a href="http://developer.openstack.org/api-ref/image/" target="_blank">http://developer.openstack.org/api-ref/image/</a><br>
> <<a href="http://developer.openstack.org/api-ref/image/" target="_blank">http://developer.openstack.org/api-ref/image/</a>> ><br>
> > heat<br>
> <a href="http://developer.openstack.org/api-ref/orchestration/" target="_blank">
http://developer.openstack.org/api-ref/orchestration/</a><br>
> <<a href="http://developer.openstack.org/api-ref/orchestration/" target="_blank">http://developer.openstack.org/api-ref/orchestration/</a>><br>
> > <<a href="http://developer.openstack.org/api-ref/orchestration/" target="_blank">http://developer.openstack.org/api-ref/orchestration/</a><br>
> <<a href="http://developer.openstack.org/api-ref/orchestration/" target="_blank">http://developer.openstack.org/api-ref/orchestration/</a>> ><br>
> > ironic<br>
> <a href="http://developer.openstack.org/api-ref/baremetal/" target="_blank">http://developer.openstack.org/api-ref/baremetal/</a><br>
> <<a href="http://developer.openstack.org/api-ref/baremetal/" target="_blank">http://developer.openstack.org/api-ref/baremetal/</a>><br>
> > <<a href="http://developer.openstack.org/api-ref/baremetal/" target="_blank">http://developer.openstack.org/api-ref/baremetal/</a><br>
> <<a href="http://developer.openstack.org/api-ref/baremetal/" target="_blank">http://developer.openstack.org/api-ref/baremetal/</a>> ><br>
> > keystone<br>
> <a href="http://developer.openstack.org/api-ref/identity/" target="_blank">http://developer.openstack.org/api-ref/identity/</a><br>
> <<a href="http://developer.openstack.org/api-ref/identity/" target="_blank">http://developer.openstack.org/api-ref/identity/</a>><br>
> > <<a href="http://developer.openstack.org/api-ref/identity/" target="_blank">http://developer.openstack.org/api-ref/identity/</a><br>
> <<a href="http://developer.openstack.org/api-ref/identity/" target="_blank">http://developer.openstack.org/api-ref/identity/</a>> ><br>
> > manila<br>
> > <a href="http://developer.openstack.org/api-ref/shared-file-systems/" target="_blank">
http://developer.openstack.org/api-ref/shared-file-systems/</a><br>
> <<a href="http://developer.openstack.org/api-ref/shared-file-systems/" target="_blank">http://developer.openstack.org/api-ref/shared-file-systems/</a>><br>
> > <<a href="http://developer.openstack.org/api-ref/shared-file-systems/" target="_blank">http://developer.openstack.org/api-ref/shared-file-systems/</a><br>
> <<a href="http://developer.openstack.org/api-ref/shared-file-systems/" target="_blank">http://developer.openstack.org/api-ref/shared-file-systems/</a>> ><br>
> > neutron-lib<br>
> <a href="http://developer.openstack.org/api-ref/networking/" target="_blank">http://developer.openstack.org/api-ref/networking/</a><br>
> <<a href="http://developer.openstack.org/api-ref/networking/" target="_blank">http://developer.openstack.org/api-ref/networking/</a>><br>
> > <<a href="http://developer.openstack.org/api-ref/networking/" target="_blank">http://developer.openstack.org/api-ref/networking/</a><br>
> <<a href="http://developer.openstack.org/api-ref/networking/" target="_blank">http://developer.openstack.org/api-ref/networking/</a>> ><br>
> > nova <a href="http://developer.openstack.org/api-ref/compute/" target="_blank">
http://developer.openstack.org/api-ref/compute/</a><br>
> <<a href="http://developer.openstack.org/api-ref/compute/" target="_blank">http://developer.openstack.org/api-ref/compute/</a>><br>
> > <<a href="http://developer.openstack.org/api-ref/compute/" target="_blank">http://developer.openstack.org/api-ref/compute/</a><br>
> <<a href="http://developer.openstack.org/api-ref/compute/" target="_blank">http://developer.openstack.org/api-ref/compute/</a>> ><br>
> > sahara<br>
> <a href="http://developer.openstack.org/api-ref/data-processing/" target="_blank">
http://developer.openstack.org/api-ref/data-processing/</a><br>
> <<a href="http://developer.openstack.org/api-ref/data-processing/" target="_blank">http://developer.openstack.org/api-ref/data-processing/</a>><br>
> > <<a href="http://developer.openstack.org/api-ref/data-processing/" target="_blank">http://developer.openstack.org/api-ref/data-processing/</a><br>
> <<a href="http://developer.openstack.org/api-ref/data-processing/" target="_blank">http://developer.openstack.org/api-ref/data-processing/</a>> ><br>
> > senlin<br>
> <a href="http://developer.openstack.org/api-ref/clustering/" target="_blank">http://developer.openstack.org/api-ref/clustering/</a><br>
> <<a href="http://developer.openstack.org/api-ref/clustering/" target="_blank">http://developer.openstack.org/api-ref/clustering/</a>><br>
> > <<a href="http://developer.openstack.org/api-ref/clustering/" target="_blank">http://developer.openstack.org/api-ref/clustering/</a><br>
> <<a href="http://developer.openstack.org/api-ref/clustering/" target="_blank">http://developer.openstack.org/api-ref/clustering/</a>> ><br>
> > swift<br>
> <a href="http://developer.openstack.org/api-ref/object-storage/" target="_blank">
http://developer.openstack.org/api-ref/object-storage/</a><br>
> <<a href="http://developer.openstack.org/api-ref/object-storage/" target="_blank">http://developer.openstack.org/api-ref/object-storage/</a>><br>
> > <<a href="http://developer.openstack.org/api-ref/object-storage/" target="_blank">http://developer.openstack.org/api-ref/object-storage/</a><br>
> <<a href="http://developer.openstack.org/api-ref/object-storage/" target="_blank">http://developer.openstack.org/api-ref/object-storage/</a>> ><br>
> > zaqar <a href="http://developer.openstack.org/api-ref/messaging/" target="_blank">
http://developer.openstack.org/api-ref/messaging/</a><br>
> <<a href="http://developer.openstack.org/api-ref/messaging/" target="_blank">http://developer.openstack.org/api-ref/messaging/</a>><br>
> > <<a href="http://developer.openstack.org/api-ref/messaging/" target="_blank">http://developer.openstack.org/api-ref/messaging/</a><br>
> <<a href="http://developer.openstack.org/api-ref/messaging/" target="_blank">http://developer.openstack.org/api-ref/messaging/</a>> ><br>
> ><br>
> ><br>
> ><br>
> > These projects are using the in-tree workflow and common<br>
> tools,<br>
> > but do not have a publish job in project-config in the<br>
> > jenkins/jobs/projects.yaml file.<br>
> ><br>
> ><br>
> ><br>
> > ceilometer<br>
> ><br>
> ><br>
> ><br>
> > --Projects not using common tooling--<br>
> ><br>
> > These projects have API docs but are not yet using the<br>
> common tooling,<br>
> > as far as I can tell. Because of the user experience, I'm making<br>
> a judgement<br>
> > call that these cannot be included in the common navigation. I<br>
> have patched<br>
> > the projects.yaml file in the governance repo with the URLs I<br>
> could<br>
> > screen-scrape, but if I'm incorrect please do patch the<br>
> projects.yaml in<br>
> > the governance repo.<br>
> ><br>
> ><br>
> ><br>
> > astara<br>
> ><br>
> > cloudkitty<br>
> ><br>
> > congress<br>
> ><br>
> > magnum<br>
> ><br>
> > mistral<br>
> ><br>
> > monasca<br>
> ><br>
> > solum<br>
> ><br>
> > tacker<br>
> ><br>
> > trove<br>
> ><br>
> ><br>
> ><br>
> > Please reach out if you have questions or need assistance<br>
> getting<br>
> > started with the new common tooling, documented here:<br>
> > <a href="http://docs.openstack.org/contributor-guide/api-guides.html" target="_blank">
http://docs.openstack.org/contributor-guide/api-guides.html</a><br>
> <<a href="http://docs.openstack.org/contributor-guide/api-guides.html" target="_blank">http://docs.openstack.org/contributor-guide/api-guides.html</a>><br>
><br>
> > <<a href="http://docs.openstack.org/contributor-guide/api-guides.html" target="_blank">http://docs.openstack.org/contributor-guide/api-guides.html</a><br>
> <<a href="http://docs.openstack.org/contributor-guide/api-guides.html" target="_blank">http://docs.openstack.org/contributor-guide/api-guides.html</a>> > .<br>
> ><br>
> ><br>
> ><br>
> > For searchlight, looking at<br>
> > <a href="http://developer.openstack.org/api-ref/search/" target="_blank">
http://developer.openstack.org/api-ref/search/</a><br>
> <<a href="http://developer.openstack.org/api-ref/search/" target="_blank">http://developer.openstack.org/api-ref/search/</a>><br>
> > <<a href="http://developer.openstack.org/api-ref/search/" target="_blank">http://developer.openstack.org/api-ref/search/</a><br>
> <<a href="http://developer.openstack.org/api-ref/search/" target="_blank">http://developer.openstack.org/api-ref/search/</a>> > they have the build<br>
> > job, but the info is not complete yet.<br>
> ><br>
> ><br>
> ><br>
> > One additional project I'm not sure what to do with is<br>
> > networking-nfc, since I'm not sure it is considered a neutron<br>
> API. Can I<br>
> > get help to sort that question out?<br>
> ><br>
> ><br>
> > --Redirects from old pages--<br>
> ><br>
> > We have been adding .htaccess redirects from the old<br>
> > api-ref-servicename.html on <a href="http://developer.openstack.org" target="_blank">
developer.openstack.org</a><br>
> <<a href="http://developer.openstack.org" target="_blank">http://developer.openstack.org</a>><o:p></o:p></p>
</div>
</div>
<p class="MsoNormal">> > <<a href="http://developer.openstack.org" target="_blank">http://developer.openstack.org</a><o:p></o:p></p>
<div>
<div>
<p class="MsoNormal">> <<a href="http://developer.openstack.org" target="_blank">http://developer.openstack.org</a>> > as teams are comfortable with the<br>
> > accuracy of information and build stability. Please help out by<br>
> patching<br>
> > the api-site repository's .htaccess file when you are ready to<br>
> redirect.<br>
> > These projects could be ready for redirects but do not have them:<br>
> ><br>
> ><br>
> ><br>
> > designate<br>
> ><br>
> > glance<br>
> ><br>
> > heat<br>
> ><br>
> > sahara<br>
> ><br>
> > senlin<br>
> ><br>
> > swift<br>
> ><br>
> ><br>
> ><br>
> > I'm available for questions so please reach out as needed.<br>
> I hope<br>
> > this covers our current status.<br>
> ><br>
> ><br>
> ><br>
> > A million thank yous to everyone who got us this far! Great<br>
> teamwork,<br>
> > great docs work, great UI work, and great API work everyone.<br>
> ><br>
> > Anne<br>
> ><br>
> ><br>
> ><br>
> > --<br>
> ><br>
> > Anne Gentle<br>
> ><br>
> > <a href="http://www.justwriteclick.com" target="_blank">www.justwriteclick.com</a> <<a href="http://www.justwriteclick.com" target="_blank">http://www.justwriteclick.com</a>><br>
> <<a href="http://www.justwriteclick.com" target="_blank">http://www.justwriteclick.com</a>><br>
> ><br>
> ><br>
> > _______________________________________________<br>
> > OpenStack-docs mailing list<br>
> > <a href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.openstack.org</a><br>
> <mailto:<a href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.openstack.org</a>><o:p></o:p></p>
</div>
</div>
<p class="MsoNormal">> > <mailto:<a href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.openstack.org</a><o:p></o:p></p>
<div>
<div>
<p class="MsoNormal" style="margin-bottom:12.0pt">> <mailto:<a href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.openstack.org</a>> ><br>
> ><br>
> <a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-" target="_blank">
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-</a><br>
> <<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-</a>><br>
> > docs<br>
> ><br>
> <<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
> <<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a>> ><br>
> ><br>
> ><br>
> ><br>
> ><br>
> ><br>
> ><br>
> > --<br>
> ><br>
> > Anne Gentle<br>
> > <a href="http://www.justwriteclick.com" target="_blank">www.justwriteclick.com</a> <<a href="http://www.justwriteclick.com" target="_blank">http://www.justwriteclick.com</a>><br>
> <<a href="http://www.justwriteclick.com" target="_blank">http://www.justwriteclick.com</a>><br>
><br>
><br>
> _______________________________________________<br>
> OpenStack-docs mailing list<br>
> <a href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.openstack.org</a><br>
> <mailto:<a href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.openstack.org</a>><br>
> <a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-</a><br>
> docs<br>
> <<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a>><br>
><br>
><br>
><br>
><br>
><br>
> --<br>
><br>
> Anne Gentle<br>
> <a href="http://www.justwriteclick.com" target="_blank">www.justwriteclick.com</a> <<a href="http://www.justwriteclick.com" target="_blank">http://www.justwriteclick.com</a>><o:p></o:p></p>
</div>
</div>
</blockquote>
</div>
<p class="MsoNormal"><br>
<br clear="all">
<o:p></o:p></p>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<p class="MsoNormal">-- <o:p></o:p></p>
<div>
<div>
<div>
<div>
<div>
<p class="MsoNormal">Anne Gentle<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><a href="http://www.justwriteclick.com" target="_blank"><span style="font-size:9.5pt">www.justwriteclick.com</span></a><o:p></o:p></p>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</body>
</html>