<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=Windows-1252">
</head>
<body style="word-wrap:break-word">
Another thing to consider is how would you write a heat resource to consume the new api. Usually you can find api problems while considering this case. Heat's resources are very light weight to implement if the api is good. Quite difficult when not.<br>
<br>
Thanks,<br>
Kevin <strong>
<div><font face="Tahoma" color="#000000" size="2"> </font></div>
</strong>
<hr tabindex="-1">
<font face="Tahoma" size="2"><b>From:</b> Everett Toews<br>
<b>Sent:</b> Tuesday, June 23, 2015 6:58:52 AM<br>
<b>To:</b> OpenStack Development Mailing List (not for usage questions)<br>
<b>Subject:</b> Re: [openstack-dev] [api][Solum] Request for feedback on new API resource<br>
</font><br>
<div></div>
<div>
<div>
<div>
<div>On Jun 18, 2015, at 3:07 PM, Devdatta Kulkarni <<a href="mailto:devdatta.kulkarni@RACKSPACE.COM">devdatta.kulkarni@RACKSPACE.COM</a>> wrote:</div>
<br class="Apple-interchange-newline">
<blockquote type="cite">
<div dir="ltr" style="font-style:normal; font-variant:normal; font-weight:normal; letter-spacing:normal; line-height:normal; orphans:auto; text-align:start; text-indent:0px; text-transform:none; white-space:normal; widows:auto; word-spacing:0px; font-size:12pt; background-color:rgb(255,255,255); font-family:Calibri,Arial,Helvetica,sans-serif; position:static; z-index:auto">
<div style="margin-top:0px; margin-bottom:0px">Hi, API WG team,</div>
<div style="margin-top:0px; margin-bottom:0px"><br>
</div>
<div style="margin-top:0px; margin-bottom:0px">In Solum, recently we have been working on some changes to our REST API.</div>
<div style="margin-top:0px; margin-bottom:0px"><br>
</div>
<div style="margin-top:0px; margin-bottom:0px">Basically, we have introduced a new resource ('app'). The spec for this has been accepted by Solum cores.<br>
</div>
<div style="margin-top:0px; margin-bottom:0px"><a href="https://github.com/stackforge/solum-specs/blob/master/specs/liberty/app-resource.rst">https://github.com/stackforge/solum-specs/blob/master/specs/liberty/app-resource.rst</a></div>
<div style="margin-top:0px; margin-bottom:0px"><br>
</div>
<div style="margin-top:0px; margin-bottom:0px">Right now we have a patch for review implementing this spec:</div>
<div style="margin-top:0px; margin-bottom:0px"><a href="https://review.openstack.org/#/c/185147/">https://review.openstack.org/#/c/185147/</a></div>
<div style="margin-top:0px; margin-bottom:0px"><br>
</div>
<div style="margin-top:0px; margin-bottom:0px">If it is not too much to request, I was wondering if someone from your team can take a look</div>
<div style="margin-top:0px; margin-bottom:0px">at the spec and the review, to see if we are not violating any of your guidelines.</div>
<div style="margin-top:0px; margin-bottom:0px"><br>
</div>
<div style="margin-top:0px; margin-bottom:0px">Thank you for your help.</div>
<div style="margin-top:0px; margin-bottom:0px"><br>
</div>
<div style="margin-top:0px; margin-bottom:0px">- Devdatta<br>
</div>
</div>
</blockquote>
<div><br>
</div>
<div>Do you have this API documented anywhere?</div>
<div><br>
</div>
<div>Is there a spec or similar for this API change?</div>
<div><br>
</div>
<div>In our experience, it’s best to consider the API design apart from the implementation. The separation of concerns makes for a cleaner review and a better design. The Glance team did a good job of this in their Artifact Repository API specification [1].</div>
<div><br>
</div>
<div>Regards,</div>
<div>Everett</div>
<div><br>
</div>
<div>[1] <a href="https://review.openstack.org/#/c/177397/">https://review.openstack.org/#/c/177397/</a></div>
</div>
</div>
</div>
</body>
</html>