I would add, for the resultset feed-level metadata, always include the resultset count and the total count. Helps on the client-side, not making a ton of unwanted requests. <div><br></div><div>I can gin up some stats this week, definitely by November, if that is of interest (noting that the set i use is not limited to EO data sites).</div><div><br></div><div>Soren<span></span><br><br>On Monday, October 12, 2015, Ruth Duerr via Esip-discovery <<a href="mailto:esip-discovery@lists.esipfed.org">esip-discovery@lists.esipfed.org</a>> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div style="word-wrap:break-word">Hi Doug,<div><br></div><div>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><br></div><div>Ruth<br><br>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><br>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><br>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><br>Recommend ATOM. <br><br>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" target="_blank">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><br>We need some structure to support enumerations/controlled vocabs per parameter and an understanding of how these work with the optional/required parameters. <br><br>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><div><br></div>Lastly, shouldn't the best practice include having these service links on a data set’s landing page?</div><div><br></div><div><br><div><blockquote type="cite"><div>On Oct 12, 2015, at 2:11 PM, Doug Newman via Esip-discovery <<a href="javascript:_e(%7B%7D,'cvml','esip-discovery@lists.esipfed.org');" target="_blank">esip-discovery@lists.esipfed.org</a>> wrote:</div><br><div>
  

    
  
  <div bgcolor="#FFFFFF" text="#000000">
    Ladies and gentlemen,<br>
    <br>
    Link: <a href="http://wiki.esipfed.org/index.php/Discovery_Telecon_2015-09-14" target="_blank">http://wiki.esipfed.org/index.php/Discovery_Telecon_2015-09-14</a><br>
    <br>
    <h2><span>Pending Actions </span></h2>
    <ul>
      
      <li> ESRI and Open Search Best Practices - Doug. In progress
      </li>
      <li> Review Web Service Mission statement <a href="http://wiki.esipfed.org/index.php/WebServiceMission" target="_blank">http://wiki.esipfed.org/index.php/WebServiceMission</a>
        - ALL
      </li>
      <li> Re-visit NCEI geoportal server OpenSearch capabilities using
        CWICSmart OpenSearch Client - Yuanjie Li
      </li>
      <li> 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> Contact Erin regarding the note taker for the ESIP session on
        Service Discovery - Ruth
      </li>
      <li> Continue to investigate opening up Web Services Cluster -
        Soren
      </li>
      <li> Monitor situation on AGU Union Demo session for suitability
        of 'Global OpenSearch' Demo - Doug
      </li>
      <ul>
      </ul>
    </ul>
    <h2><span></span><span>Agenda </span></h2>
    
    <ul>
      <li> OpenSearch Validation Tool
      </li>
      <li> OpenSearch standards decision
      </li>
      <li> Web Services Cluster
      </li>
    </ul>
    <h2><span>Webex Info </span></h2><p>To Join the online portion of the Personal Conference meeting </p>
    <hr>
    <ol>
      <li> Go to <a href="https://esipfed.webex.com/" target="_blank">https://esipfed.webex.com</a>
      </li>
      <li> Click the “Meeting Center” tab </li>
      <li> Select the Discovery </li>
    </ol><p>If a password is required, enter the Meeting Password: 23138372 </p><p>To start the audio portion of the Personal Conference meeting w/
      phone </p>
    <hr>
    <ul>
      <li> Call-in toll-free number (US/Canada): 1-877-668-4493 </li>
      <li> Call-in toll number (US/Canada): +1-408-600-3600 </li>
      <li> Call-in toll number (US/Canada)*: +1-571-918-6008 </li>
    </ul><p>Attendee access code: 231 383 72 </p>
    <pre cols="72">-- 
Doug Newman - NASA Earthdata Operations Lead
<a href="javascript:_e(%7B%7D,'cvml','douglas.j.newman@nasa.gov');" target="_blank">douglas.j.newman@nasa.gov</a>
<a href="javascript:_e(%7B%7D,'cvml','doug_newman@raytheon.com');" target="_blank">doug_newman@raytheon.com</a>
Raytheon Mission Support Solutions Intelligence, Information and Services | NASA | ECS Evolution Development Program
<a href="http://earthdata.nasa.gov/" target="_blank">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>Esip-discovery mailing list<br><a href="javascript:_e(%7B%7D,'cvml','Esip-discovery@lists.esipfed.org');" target="_blank">Esip-discovery@lists.esipfed.org</a><br><a href="http://lists.deltaforce.net/mailman/listinfo/esip-discovery" target="_blank">http://lists.deltaforce.net/mailman/listinfo/esip-discovery</a><br></div></blockquote></div><br></div></div></blockquote></div>