<html><head><meta http-equiv="Content-Type" content="text/html charset=utf-8"></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class="">Hi Doug,<div class=""><br class=""></div><div class="">I’ve got a list of potential improvements to the OpenSearch spec/best practices that we ought to discuss though some are also recommendations for web service documentation in general.  See below…</div><div class=""><br class=""></div><div class="">Ruth<br class=""><br class="">Currently, there is no way to tell whether an open search end point is describing a data set search or a granule search or what.  There needs to be a way to state that (naming practices just don’t work).  A parameter could do this or some other extension would be needed.  It would need to handle generic well-defined parameters so it could be validated with standard XML tooling (namespacing a substring within an attribute is not a safe long-term solution). At that point, we ought to define an exemplar for the nested search. <br class=""><br class="">OSDD rel link references should be included in any child OSDD throughout any OSDD hierarchy, so that traveling both up and down the hierarchy is possible and easy.</div><div class=""><br class="">Put the parent OSDD rel link in the ATOM result set (rss is an issue). Basic provenance. Just part of the feed metadata before the item list. <br class=""><br class="">Recommend ATOM. <br class=""><br class="">Make some recommendations for semantic markup in the result set content. Commonplace practice is to encode that as HTML so let's take advantage of that and include rel tags for dataset, landing page, etc, and <a href="http://schema.org" class="">schema.org</a> tags if that's still of use. We have, I think, been neglecting the utility of the search response to everyone (crawler, broker, person at a keyboard) and that is, frankly, the place where we actually get an understanding of data/no data. So let's make it useful.<br class=""><br class="">We need some structure to support enumerations/controlled vocabs per parameter and an understanding of how these work with the optional/required parameters. <br class=""><br class="">Also, shouldn’t each web service like this have a unique identifier? What is a unique identifier for an OpenSearch? For a dataset OpenSearch?<br class=""><div class=""><br class=""></div>Lastly, shouldn't the best practice include having these service links on a data set’s landing page?</div><div class=""><br class=""></div><div class=""><br class=""><div><blockquote type="cite" class=""><div class="">On Oct 12, 2015, at 2:11 PM, 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"><div class="">
  

    <meta http-equiv="content-type" content="text/html; charset=utf-8" class="">
  
  <div bgcolor="#FFFFFF" text="#000000" class="">
    Ladies and gentlemen,<br class="">
    <br class="">
    Link: <a class="moz-txt-link-freetext" href="http://wiki.esipfed.org/index.php/Discovery_Telecon_2015-09-14">http://wiki.esipfed.org/index.php/Discovery_Telecon_2015-09-14</a><br class="">
    <br class="">
    <h2 class=""><span class="mw-headline" id="Pending_Actions">Pending Actions </span></h2>
    <ul class="">
      <meta http-equiv="content-type" content="text/html; charset=utf-8" class="">
      <li class=""> ESRI and Open Search Best Practices - Doug. In progress
      </li>
      <li class=""> Review Web Service Mission statement <a class=" external
 free" href="http://wiki.esipfed.org/index.php/WebServiceMission">http://wiki.esipfed.org/index.php/WebServiceMission</a>
        - ALL
      </li>
      <li class=""> Re-visit NCEI geoportal server OpenSearch capabilities using
        CWICSmart OpenSearch Client - Yuanjie Li
      </li>
      <li class=""> ESO - Make decision on whether to wait for Draft 2 of CEOS BP
        or recommend CEOS BP + CEOS DEV Guide as standard for OpenSearch
      </li>
      <li class=""> Contact Erin regarding the note taker for the ESIP session on
        Service Discovery - Ruth
      </li>
      <li class=""> Continue to investigate opening up Web Services Cluster -
        Soren
      </li>
      <li class=""> Monitor situation on AGU Union Demo session for suitability
        of 'Global OpenSearch' Demo - Doug
      </li>
      <ul class="">
      </ul>
    </ul>
    <h2 class=""><span class="editsection"></span><span class="mw-headline" id="Agenda">Agenda </span></h2>
    <meta http-equiv="content-type" content="text/html; charset=utf-8" class="">
    <ul class="">
      <li class=""> OpenSearch Validation Tool
      </li>
      <li class=""> OpenSearch standards decision
      </li>
      <li class=""> Web Services Cluster
      </li>
    </ul>
    <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 - NASA Earthdata 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/">http://earthdata.nasa.gov/</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>

_______________________________________________<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></body></html>