<div dir="ltr"><br><div class="gmail_extra"><br><br><div class="gmail_quote">On Thu, Sep 12, 2013 at 10:41 PM, Monty Taylor <span dir="ltr"><<a href="mailto:mordred@inaugust.com" target="_blank">mordred@inaugust.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div class="im"><br>
<br>
On 09/12/2013 04:33 PM, Steve Baker wrote:<br>
> On 09/13/2013 08:28 AM, Mike Asthalter wrote:<br>
>> Hello,<br>
>><br>
>> Can someone please explain the plans for our 2 wadls moving forward:<br>
>><br>
</div>>> * wadl in original heat<br>
>> repo: <a href="https://github.com/openstack/heat/blob/master/doc/docbkx/api-ref/src/wadls/heat-api/src/heat-api-1.0.wadl" target="_blank">https://github.com/openstack/heat/blob/master/doc/docbkx/api-ref/src/wadls/heat-api/src/heat-api-1.0.wadl</a><br>
>> <%22<a href="https://github.com/openstack/heat/blob/master/doc/docbkx/api-ref/src/wadls/heat-api/src/heat-api-1" target="_blank">https://github.com/openstack/heat/blob/master/doc/docbkx/api-ref/src/wadls/heat-api/src/heat-api-1</a>.><br>
>> * wadl in api-site<br>
<div class="im">>> repo: <a href="https://github.com/openstack/api-site/blob/master/api-ref/src/wadls/orchestration-api/src/v1/orchestration-api.wadl" target="_blank">https://github.com/openstack/api-site/blob/master/api-ref/src/wadls/orchestration-api/src/v1/orchestration-api.wadl</a><br>
>><br>
> The original intention was to delete the heat wadl when the api-site one<br>
> became merged.<br></div></blockquote><div><br></div><div>Sounds good. </div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div class="im">
>> 1. Is there a need to maintain 2 wadls moving forward, with the wadl<br>
>> in the original heat repo containing calls that may not be<br>
>> implemented, and the wadl in the api-site repo containing implemented<br>
>> calls only?<br>
>><br>
>> Anne Gentle advises as follows in regard to these 2 wadls:<br>
>><br>
>> "I'd like the WADL in api-site repo to be user-facing. The other<br>
>> WADL can be truth if it needs to be a specification that's not yet<br>
>> implemented. If the WADL in api-site repo is true and implemented,<br>
>> please just maintain one going forward."<br>
>><br>
>><br>
>> 2. If we maintain 2 wadls, what are the consequences (gerrit reviews,<br>
>> docs out of sync, etc.)?<br>
>><br>
>> 3. If we maintain only the 1 orchestration wadl, how do we want to<br>
>> pull in the wadl content to the api-ref doc<br>
>> (<a href="https://github.com/openstack/heat/blob/master/doc/docbkx/api-ref/src/docbkx/api-ref.xml" target="_blank">https://github.com/openstack/heat/blob/master/doc/docbkx/api-ref/src/docbkx/api-ref.xml</a><br>
</div>>> <%22<a href="https://github.com/openstack/heat/blob/master/doc/docbkx/api-ref/src/docb" target="_blank">https://github.com/openstack/heat/blob/master/doc/docbkx/api-ref/src/docb</a>>)<br>
<div class="im">>> from the orchestration wadl in the api-site repo: subtree merge, other?<br>
>><br>
>><br></div></blockquote><div><br></div><div>Thanks Mike for asking these questions. </div><div><br></div><div>I've been asking the infrastructure team for help with pulling content like the current nova request/response examples into the api-site repo. No subtree merges please. We'll find some way. Right now it's manual.</div>
<div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div class="im">
> These are good questions, and could apply equally to other out-of-tree<br>
> docs as features get added during the development cycle.<br>
><br>
> I still think that our wadl should live only in api-site. If api-site<br>
> has no branching policy to maintain separate Havana and Icehouse<br>
> versions then maybe Icehouse changes should be posted as WIP reviews<br>
> until they can be merged.<br>
<br>
</div>I believe there is no branching in api-site because it's describing API<br>
and there is no such thing as a havana or icehouse version of an API -<br>
there are the API versions and they are orthogonal to server release<br>
versions. At least in theory. :)<br></blockquote><div><br></div><div>Yep, that's our working theory. :)</div><div><br></div><div>Anne </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<br>
_______________________________________________<br>
OpenStack-dev mailing list<br>
<a href="mailto:OpenStack-dev@lists.openstack.org">OpenStack-dev@lists.openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev</a><br>
</blockquote></div><br><br clear="all"><div><br></div>-- <br>Anne Gentle<br><a href="mailto:annegentle@justwriteclick.com" target="_blank">annegentle@justwriteclick.com</a>
</div></div>