
<html>

<head>

<meta http-equiv="Content-Type" content="text/html; charset=Windows-1252">

</head>

<body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;">

<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; -webkit-text-stroke-width: 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>

</body>

</html>