<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>Hi Anne,</div>
<div><br>
</div>
<div>I want to make sure I've understood the ramifications of your statement about content sharing.</div>
<div><br>
</div>
<div>So for now, until the infrastructure team provides us with a method to share content between repos, the only way to share the content from the orchestration wadl with the api-ref doc (<span class="Apple-style-span" style="font-family: Cambria; font-size: 12px; color: rgb(27, 57, 245); "><span style="text-decoration: underline; "><a href="applewebdata://ADF909E2-ABA6-4E57-81C2-41FC459CA6DF/%22https://github.com/openstack/heat/blob/master/doc/docbkx/api-ref/src/docb">https://github.com/openstack/heat/blob/master/doc/docbkx/api-ref/src/docbkx/api-ref.xml</a></span></span><span style="color: rgb(0, 0, 0); font-size: 14px; font-style: normal; font-weight: normal; text-decoration: none; font-family: Calibri, sans-serif; ">)
is to manually copy the content from the orchestration wadl to the original heat wadl and then use that for the shared content. </span>So we will not delete the original heat wadl until that new method of content sharing is in place. Is this correct? </div>
<div><br>
</div>
<div><br>
</div>
<div>Thanks!</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:annegentle@justwriteclick.com">annegentle@justwriteclick.com</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>Thursday, September 12, 2013 11:32 PM<br>
<span style="font-weight:bold">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">Subject: </span>Re: [openstack-dev] [Heat] Questions about plans for heat wadls moving forward<br>
</div>
<div><br>
</div>
<div>
<div>
<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>
</div>
</div>
</div>
</span><span id="OLK_SRC_BODY_SECTION">
<div>
<div>
<div dir="ltr">
<div class="gmail_extra">
<div class="gmail_quote">
<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>
</div>
</div>
</span>
</body>
</html>