<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
</head>
<body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; color: rgb(0, 0, 0); font-size: 14px; font-family: Calibri, sans-serif; ">
<div>Just a couple notes about #5 (inking to WADL files in separate repositories):</div>
<div><br>
</div>
<ol>
<li>This feature in supported in version 1.10.0 of the clouddocs maven plugin, which has now been reverted back to 1.9.3 due to request/response issues. You should be able to test using 1.9.4-SNAPSHOT until version 1.10.0 is available again.</li><li>You must use a <b>plain</b> URL to access the wadl. See the following example.</li></ol>
<div>
<blockquote style="margin:0 0 0 40px; border:none; padding:0px;">
<div>For example, to get the plain version for the following URL:</div>
<div><br>
</div>
<div><a href="http://git.openstack.org/cgit/openstack/api-site/tree/api-ref/src/wadls/orchestration-api/src/v1/orchestration-api.wadl">http://git.openstack.org/cgit/openstack/api-site/tree/api-ref/src/wadls/orchestration-api/src/v1/orchestration-api.wadl</a></div>
<div><br>
</div>
<div>Browse to the above location in Firefox, and then click (<a href="http://git.openstack.org/cgit/openstack/api-site/plain/api-ref/src/wadls/orchestration-api/src/v1/orchestration-api.wadl">plain</a>) on the blob: line, just above where the wadl text appears.</div>
<div><br>
</div>
<div>This will display the plain version of the URL:</div>
<div><br>
</div>
<div><a href="http://git.openstack.org/cgit/openstack/api-site/">http://git.openstack.org/cgit/openstack/api-site/</a><span class="Apple-style-span" style="background-color: rgb(255, 255, 0); ">plain</span>/api-ref/src/wadls/orchestration-api/src/v1/orchestration-api.wadl</div>
<div><br>
</div>
<div>Then use the plain version of the URL to access the wadl resources in the API Devguide:</div>
<div><br>
</div>
</blockquote>
<div>
<blockquote style="margin:0 0 0 40px; border:none; padding:0px;">
<p style="margin-top: 0px; margin-right: 0px; margin-bottom: 0px; margin-left: 0px; font: normal normal normal 12px/normal Helvetica; color: rgb(184, 63, 19); ">
<span style="color: rgb(0, 34, 161); "><wadl:resources</span><span style="color: rgb(0, 0, 0); "><br>
</span><span style="color: rgb(255, 147, 102); "> href</span><span style="color: rgb(255, 143, 90); ">=</span>"<a href="http://git.openstack.org/cgit/openstack/api-site/plain/api-ref/src/wadls/orchestration-api/src/v1/orchestration-api.wadl">http://git.openstack.org/cgit/openstack/api-site/plain/api-ref/src/wadls/orchestration-api/src/v1/orchestration-api.wadl</a>"<span style="color: rgb(0, 0, 0); "><br>
</span><span style="color: rgb(255, 147, 102); "> </span><span style="color: rgb(0, 172, 210); ">xmlns:wadl</span><span style="color: rgb(255, 143, 90); ">=</span>"<a href="http://wadl.dev.java.net/2009/02">http://wadl.dev.java.net/2009/02</a>"<span style="color: rgb(0, 34, 161); ">/></span></p>
</blockquote>
</div>
</div>
<div><br>
</div>
<div>Mike</div>
<div><br>
</div>
<span id="OLK_SRC_BODY_SECTION">
<div style="font-family:Calibri; font-size:11pt; text-align:left; color:black; BORDER-BOTTOM: medium none; BORDER-LEFT: medium none; PADDING-BOTTOM: 0in; PADDING-LEFT: 0in; PADDING-RIGHT: 0in; BORDER-TOP: #b5c4df 1pt solid; BORDER-RIGHT: medium none; PADDING-TOP: 3pt">
<span style="font-weight:bold">From: </span>Anne Gentle <<a href="mailto:anne@openstack.org">anne@openstack.org</a>><br>
<span style="font-weight:bold">Reply-To: </span>OpenStack Development Mailing List <<a href="mailto:openstack-dev@lists.openstack.org">openstack-dev@lists.openstack.org</a>><br>
<span style="font-weight:bold">Date: </span>Wednesday, September 18, 2013 8:36 PM<br>
<span style="font-weight:bold">To: </span>"<a href="mailto:openstack-docs@lists.openstack.org">openstack-docs@lists.openstack.org</a>" <<a href="mailto:openstack-docs@lists.openstack.org">openstack-docs@lists.openstack.org</a>>, OpenStack Development Mailing
List <<a href="mailto:openstack-dev@lists.openstack.org">openstack-dev@lists.openstack.org</a>><br>
<span style="font-weight:bold">Cc: </span>Glen Campbell <<a href="mailto:glen.campbell@RACKSPACE.COM">glen.campbell@RACKSPACE.COM</a>><br>
<span style="font-weight:bold">Subject: </span>[openstack-dev] What's Up Doc? Sep 18 2013<br>
</div>
<div><br>
</div>
<div>
<div>
<div dir="ltr">
<p class="">Less than a month until the Oct. 17th timed release! We're in better shape than in past releases but the install guide consolidation is crucial and there are many doc bugs. It's crunch time!</p>
<p class="">1. In review and merged this past week:</p>
<p class="">Congrats to Michael Still for his first doc patches to openstack-manuals! He got his new skillz at boot camp. Thanks for the patches!</p>
<p class="">I see good doc bug fixes going in, and Tom put in an update to the auto-generated tables. </p>
<p class="">We had a lot of cleanup to do for the flattening of directories but I think it has mostly settled now. The last step is to move the Networking Admin Guide's content into the correct locations (install or config or admin). Nermina's on it, assigned
to bug <span style="font-size: 13px; font-family: arial, sans-serif; "> </span><a href="https://bugs.launchpad.net/openstack-manuals/+bug/1223542" target="_blank" style="font-size:13px;font-family:arial,sans-serif">https://bugs.launchpad.net/openstack-manuals/+bug/1223542</a><font face="arial,sans-serif">. </font></p>
<p class=""><font face="arial,sans-serif">Andreas has a good Etherpad going to talk about continuous publishing: </font><a href="https://etherpad.openstack.org/Continous_Publishing" target="_blank" style="font-size:13px;font-family:arial,sans-serif">https://<span class="" style="background-color:rgb(255,255,204);color:rgb(34,34,34)">etherpad</span>.openstack.org/Continous_Publishing</a>.
It's possible we'll need to release the Cloud Admin Guide as well due to many references to configuration files. Please join in the discussion as we only have less than a month until release!</p>
<p class="">2. High priority doc work:</p>
<p class="">The install guide remains a high priority as do doc bugs. Shaun is working on a patch this week to consolidate the basic-install to create one single-sourced install-guide (which will document for yum, apt, and zypper). There were over 300 doc bugs
in openstack-manuals earlier this week as some docimpact bugs got logged, but we are making decent progress.</p>
<p class="">We also need to have someone re-run the autodoc tables and try to match up with some of the storage patches in this week: <a href="https://review.openstack.org/#/c/47044/">https://review.openstack.org/#/c/47044/</a> and <a href="https://review.openstack.org/#/c/47118/">https://review.openstack.org/#/c/47118/</a>. </p>
<p class="">3. Doc work going on that I know of:</p>
<p class="">Kersten Richter is working on the Compute API docs again and getting an environment set up. <br>
</p>
<p class="">4. New incoming doc requests:</p>
<p class="">At the Doc Boot Camp, Joe Gordon asked me to write up a checklist of sorts for what info should go along with a DocImpact flag. I wrote up my ideas in a blog post and would love more input before putting it on the wiki. </p>
<p class=""><a href="http://justwriteclick.com/2013/09/17/openstack-docimpact-flag-walk-through/">http://justwriteclick.com/2013/09/17/openstack-docimpact-flag-walk-through/</a></p>
<p class="">5. Doc tools updates:</p>
<p class="">We had a 1.10.0 release today but had to revert back to 1.9.3 due to the request/responses not appearing in the API reference page. David Cramer's aware of the problem and will work through it. </p>
<p class="">We also had a breakthrough where we can now link to WADL files in separate repositories so we have a single source of truth. Thanks to Mike Asthalter for testing! He reported that you can use this syntax in the xml doc where you want to refer to
the WADL:<br>
<br>
<wadl:resources<br>
href="<a href="http://git.openstack.org/cgit/openstack/api-site/plain/api-ref/src/wadls/orchestration-api/src/v1/orchestration-api.wadl">http://git.openstack.org/cgit/openstack/api-site/plain/api-ref/src/wadls/orchestration-api/src/v1/orchestration-api.wadl</a>"<br>
xmlns:wadl="<a href="http://wadl.dev.java.net/2009/02">http://wadl.dev.java.net/2009/02</a>"/></p>
<p class="">6. Other doc news:</p>
<p class="">We had a great time at Docs Boot Camp. I wrote up a blog entry and posted some pictures:</p>
<p class=""><a href="http://justwriteclick.com/2013/09/13/openstack-docs-boot-camp-wrap-up/">http://justwriteclick.com/2013/09/13/openstack-docs-boot-camp-wrap-up/</a><br>
</p>
<p class=""><a href="https://plus.google.com/photos/107069996006011564519/albums/5922817305073319953?authkey=CN6V5c_Aq_9w">https://plus.google.com/photos/107069996006011564519/albums/5922817305073319953?authkey=CN6V5c_Aq_9w</a><br>
</p>
<p class="">Super happy to see both VMWare and RedHat hiring upstream OpenStack writers! <br>
</p>
<p class=""><a href="http://www.linkedin.com/redir/redirect?url=http%3A%2F%2Fjobs%2Eredhat%2Ecom%2Fjobs%2Fdescriptions%2Ftechnical-writer-brisbane-queensland-australia-job-1-3925604&urlhash=XXzf" target="_blank" style="margin:0px;padding:0px;border:0px;outline:0px;font-size:13px;font-family:Helvetica,Arial,sans-serif;vertical-align:baseline;text-decoration:none;color:rgb(0,102,153);line-height:15px">http://jobs.redhat.com/jobs/descriptions/technical-writer-brisbane-queensland-australia-job-1-3925604</a><span class="" style="margin-top: 0px; margin-right: 0px; margin-bottom: 0px; margin-left: 0px; padding-top: 0px; padding-right: 0px; padding-bottom: 0px; padding-left: 0px; border-top-width: 0px; border-right-width: 0px; border-bottom-width: 0px; border-left-width: 0px; border-style: initial; border-color: initial; outline-width: 0px; outline-style: initial; outline-color: initial; font-size: 13px; vertical-align: baseline; color: rgb(0, 0, 0); line-height: 15px; font-family: Helvetica, Arial, sans-serif; "><br>
<br>
</span><a href="http://www.linkedin.com/redir/redirect?url=http%3A%2F%2Fjobs%2Evmware%2Ecom%2Fjob%2FPalo-Alto-Sr_-Technical-Writer%252C-OpenStack-Job-CA-94301%2F7043400%2F&urlhash=ZeSC" target="_blank" style="margin:0px;padding:0px;border:0px;outline:0px;font-size:13px;font-family:Helvetica,Arial,sans-serif;vertical-align:baseline;text-decoration:none;color:rgb(0,102,153);line-height:15px">http://jobs.vmware.com/job/Palo-Alto-Sr_-Technical-Writer%2C-OpenStack-Job-CA-94301/7043400/</a><br>
</p>
</div>
</div>
</div>
</span>
</body>
</html>