<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;" class="">
Soren,
<div class="">  Thanks for illuminating the issue.  I wonder if Swagger still might have some use for our main protocols at least for simple examples, or for version-specific examples.  The ability to “try it out” is extremely powerful in adoption, even if
 you’re only doing the equivalent of a Hello, world example.</div>
<div class=""><br class="">
<div>
<blockquote type="cite" class="">
<div class="">On May 13, 2015, at 1:23 PM, Soren Scott via Esip-discovery <<a href="mailto:esip-discovery@lists.esipfed.org" class="">esip-discovery@lists.esipfed.org</a>> wrote:</div>
<br class="Apple-interchange-newline">
<div class="">
<div style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class="">
<div class="">Doug and Chris (and Steve),</div>
<div class=""><br class="">
</div>
<div class="">It might be useful to clarify the use cases for Swagger, RAML, or any of those RESTful API documentation frameworks and the alignment with OGC and OpenSearch at least. From our scoping round, there’s two main cases - there’s the basic documentation
 (defining parameters, route elements) and then there’s the promise (in Swagger) of being able to “Try it out” so generating a correctly formatted request from the method document. </div>
<div class=""><br class="">
</div>
<div class="">The first is just data entry, really. The second one is where the dependencies in the OGC query parameters *and* their values or the OpenSearch parameters differences between datasets cause problems for any of these frameworks. For example, we’re
 describing a WMS so we enter WMS for the service and pick a supported version. There’s no place in Swagger to then say if you have selected SERVICE value WMS and VERSION value 1.3.0, the query parameter key is CRS instead of SRS for 1.1.1. Because it doesn’t
 grok those route or parameter dependencies, the actual generation of a correctly structured URL is back on the dev building the client or the user and not the more generic actionable self-describing services. And where having a solid Swagger and/or RAML OGC
 extension would be fantastic from a dev point of view. But it’s a modification of the spec and the interface and a conceptual understanding that the Swagger group, as of last fall, felt was an edge case that they wouldn’t support (not their idea of RESTful).</div>
<div class=""><br class="">
</div>
<div class="">For OpenSearch, it’s a question of not having a way to access the enumerations for a parameter, ie I can’t get a list of dataset names without running the dataset search and understanding how to parse that - pull the granule links and, hopefully,
 get a new OSDD back or something. We have some numbers about OS services supporting that second level OSDD access. Nothing about differing parameter requirements, though.</div>
<div class=""><br class="">
</div>
<div class="">I hear whispers of broader implementation of Swagger at different repositories but not of anyone handling the depency issues. And I am very much in favor of someone tackling the first case for things like OGC - just having some structured document
 that could be used to generate the docs for Swagger or RAML or 19119 or whatever would save so much time. But the second case is more what we’re all after. </div>
<div class=""><br class="">
</div>
<div class="">My two cents,</div>
<div class="">Soren</div>
<div class=""><br class="">
</div>
<br class="">
<div class="">
<div class="">On May 12, 2015, at 7:00 AM, Doug Newman via Esip-discovery <<a href="mailto:esip-discovery@lists.esipfed.org" class="">esip-discovery@lists.esipfed.org</a>> wrote:</div>
<br class="Apple-interchange-newline">
<blockquote type="cite" class="">
<div text="#000000" bgcolor="#FFFFFF" class="">Now with correct date:<br class="">
<br class="">
<a class="moz-txt-link-freetext" href="http://wiki.esipfed.org/index.php/Discovery_Telecon_2015-05-12">http://wiki.esipfed.org/index.php/Discovery_Telecon_2015-05-12</a><br class="">
<pre class="moz-signature" cols="72">Doug Newman - ECHO Operations Lead
<a class="moz-txt-link-abbreviated" href="mailto:douglas.j.newman@nasa.gov">douglas.j.newman@nasa.gov</a>
<a class="moz-txt-link-abbreviated" href="mailto:doug.newman@raytheon.com">doug.newman@raytheon.com</a>
Raytheon Mission Support Solutions Intelligence, Information and Services | NASA | ECS Evolution Development Program
<a class="moz-txt-link-freetext" href="http://earthdata.nasa.gov/echo">http://earthdata.nasa.gov/echo</a>

Note: I am not a government employee and have no legal authority to obligate any federal, state, or local government to perform any action of payment.</pre>
<div class="moz-cite-prefix">On 5/12/15 8:33 AM, Doug Newman wrote:<br class="">
</div>
<blockquote cite="mid:5551F308.4090600@nasa.gov" type="cite" class="">Ladies and gentlemen,<br class="">
<br class="">
Link: <a moz-do-not-send="true" class="moz-txt-link-freetext" href="http://wiki.esipfed.org/index.php/Discovery_Telecon_2015-05-11">
http://wiki.esipfed.org/index.php/Discovery_Telecon_2015-05-11</a><br class="">
<br class="">
<h2 class=""><span class="mw-headline" id="Pending_Actions">Pending Actions </span>
</h2>
<ul class="">
<li class="">Ruth Duerr: Provide a list of candidates for Service Best Practices and Validators. Done.
</li><li class="">Doug Newman: Send session ideas to Erin. Done. </li></ul>
<h2 class=""><span class="editsection"></span><span class="mw-headline" id="Agenda">Agenda
</span></h2>
<ul class="">
<li class="">Continue 'common mechanism for discovering services' discussion </li><li class="">Presenting OPeNDAP urls wrt Best Practices - next session </li><li class="">Status of Summer ESIP presentations. </li></ul>
<ul class="">
<ul class="">
<li class="">We have a draft agenda at <a moz-do-not-send="true" class="external free" href="https://docs.google.com/a/esipfed.org/spreadsheet/ccc?key=0ArDAFB2BsbfRdFpuQnpUVzJNcHM1VmRRY0pITjFSUkE#gid=1">
https://docs.google.com/a/esipfed.org/spreadsheet/ccc?key=0ArDAFB2BsbfRdFpuQnpUVzJNcHM1VmRRY0pITjFSUkE#gid=1</a>
</li><li class="">'Global OpenSearch' talk is submitted and waiting for a spot. </li><li class="">'Towards Well Described Web Services' is @ 4pm on Thursday 16th. </li></ul>
</ul>
<br class="">
<h2 class=""><span class="mw-headline" id="Webex_Info">Webex Info </span></h2>
<p class="">To Join the online portion of the Personal Conference meeting </p>
<hr class="">
<ol class="">
<li class="">Go to <a moz-do-not-send="true" class="external free" href="https://esipfed.webex.com/">
https://esipfed.webex.com</a> </li><li class="">Click the “Meeting Center” tab </li><li class="">Select the Discovery </li></ol>
<p class="">If a password is required, enter the Meeting Password: 23138372 </p>
<p class="">To start the audio portion of the Personal Conference meeting w/ phone
</p>
<hr class="">
<ul class="">
<li class="">Call-in toll-free number (US/Canada): 1-877-668-4493 </li><li class="">Call-in toll number (US/Canada): +1-408-600-3600 </li><li class="">Call-in toll number (US/Canada)*: +1-571-918-6008 </li></ul>
<p class="">Attendee access code: 231 383 72 </p>
<pre class="moz-signature" cols="72">Doug Newman - ECHO Operations Lead
<a moz-do-not-send="true" class="moz-txt-link-abbreviated" href="mailto:douglas.j.newman@nasa.gov">douglas.j.newman@nasa.gov</a>
<a moz-do-not-send="true" class="moz-txt-link-abbreviated" href="mailto:doug.newman@raytheon.com">doug.newman@raytheon.com</a>
Raytheon Mission Support Solutions Intelligence, Information and Services | NASA | ECS Evolution Development Program
<a moz-do-not-send="true" class="moz-txt-link-freetext" href="http://earthdata.nasa.gov/echo">http://earthdata.nasa.gov/echo</a>

Note: I am not a government employee and have no legal authority to obligate any federal, state, or local government to perform any action of payment.</pre>
<br class="">
</blockquote>
<br class="">
</div>
_______________________________________________<br class="">
Esip-discovery mailing list<br class="">
<a href="mailto:Esip-discovery@lists.esipfed.org" class="">Esip-discovery@lists.esipfed.org</a><br class="">
<a href="http://lists.deltaforce.net/mailman/listinfo/esip-discovery" class="">http://lists.deltaforce.net/mailman/listinfo/esip-discovery</a><br class="">
</blockquote>
</div>
<br class="">
</div>
_______________________________________________<br class="">
Esip-discovery mailing list<br class="">
<a href="mailto:Esip-discovery@lists.esipfed.org" class="">Esip-discovery@lists.esipfed.org</a><br class="">
http://lists.deltaforce.net/mailman/listinfo/esip-discovery<br class="">
</div>
</blockquote>
</div>
<br class="">
<div class=""><span class="Apple-style-span" style="border-collapse: separate; color: rgb(0, 0, 0); font-family: 'Times New Roman'; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: 2; text-align: -webkit-auto; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-border-horizontal-spacing: 0px; -webkit-border-vertical-spacing: 0px; -webkit-text-decorations-in-effect: none; -webkit-text-size-adjust: auto; -webkit-text-stroke-width: 0px;  "><span class="Apple-style-span" style="orphans: 2; text-align: -webkit-auto; text-indent: 0px; widows: 2; -webkit-text-decorations-in-effect: none; ">
<div style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; " class="">
<span class="Apple-style-span" style="orphans: 2; text-align: -webkit-auto; text-indent: 0px; widows: 2; -webkit-text-decorations-in-effect: none; ">
<div style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; " class="">
<div style="border-collapse: separate; color: rgb(0, 0, 0); font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-size-adjust: auto; -webkit-text-stroke-width: 0px; font-family: 'Times New Roman';  -webkit-border-horizontal-spacing: 0px; -webkit-border-vertical-spacing: 0px; " class="">
<div class="">--</div>
Dr. Christopher Lynnes     NASA/GSFC, Code 610.2    phone: 301-614-5185</div>
<div class="">"Perfection is achieved, not when there is nothing left to add, but when there is nothing left to take away" -- A. de Saint-Exupery<br class="">
<br class="">
</div>
<div style="border-collapse: separate; color: rgb(0, 0, 0); font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-size-adjust: auto; -webkit-text-stroke-width: 0px; font-family: 'Times New Roman';  -webkit-border-horizontal-spacing: 0px; -webkit-border-vertical-spacing: 0px; " class="">
<br class="">
</div>
</div>
</span><br class="Apple-interchange-newline">
</div>
</span><br class="Apple-interchange-newline">
</span><br class="Apple-interchange-newline">
</div>
<br class="">
</div>
</body>
</html>