define the search resource

Here's the initial proposal for the definition of the `search` resource.

## Search Resource

The search resource defines the set of entries in the system that are applicable to specific search criteria.

Links to the search resource should be defined using a URI template as defined by <a href="http://tools.ietf.org/html/draft-gregorio-uritemplate">the
latest URI template specification draft</a>. Implementations are free to choose which parameters are supported and how to apply them to their
URI space, but the following parameters are reserved for conformance to the GEDCOM X specification and are defined as follows:

<table>
<tr>
<th>variable</th>
<th>description</th>
</tr>
<tr>
<td>startIndex</td>
<td>The index of the first search result desired by the search client. See
<a href="http://www.opensearch.org/Specifications/OpenSearch/1.1#The_.22startIndex.22_parameter">OpenSearch parameters: startIndex</a>.</td>
</tr>
<tr>

<td>count</td>
<td>The number of search results per page desired by the search client. See
<a href="http://www.opensearch.org/Specifications/OpenSearch/1.1#The_.22count.22_parameter">OpenSearch parameters: count</a>.</td>
</tr>
<tr>
<td>resourceType</td>
<td>The type of the resources to search for. Valid values include "<tt>person</tt>" to search for conclusion persons and "<tt>person-matches</tt>" to
search for matches of a person.</td>
</tr>

<tr>
<td>name</td>
<td>The full name (given + family) of the person being searched.</td>
</tr>
<tr>
<td>givenName</td>
<td>The given name of the person being searched.</td>
</tr>
<tr>
<td>familyName</td>
<td>The family name of the person being searched.</td>

</tr>
<tr>
<td>gender</td>
<td>The gender of the person being searched. Valid values are "<tt>male</tt>" and "<tt>female</tt>".</td>
</tr>
<tr>
<td>birthDate</td>
<td>The birth date of the person being searched.</td>
</tr>

<tr>
<td>birthPlace</td>
<td>The birth place of the person being searched.</td>
</tr>
<tr>
<td>deathDate</td>
<td>The death date of the person being searched.</td>
</tr>
<tr>
<td>deathPlace</td>
<td>The death place of the person being searched.</td>

</tr>
<tr>
<td>marriageDate</td>
<td>The marriage date of the person being searched.</td>
</tr>
<tr>
<td>marriagePlace</td>
<td>The marriage place of the person being searched.</td>
</tr>
<tr>
<td colspan="2">
<h4>Relation Search Parameters</h4>

<p>The following set of standard parameters is defined as the substitution of <tt>{relation}</tt> with all of the
values "<tt>father</tt>", "<tt>mother</tt>", "<tt>spouse</tt>", and "<tt>parent</tt>".</p>
</td>
</tr>
<tr>
<td>{relation}Name</td>

<td>The full name (given + family) of the {relation} of the person being searched.</td>
</tr>
<tr>
<td>{relation}GivenName</td>
<td>The given name of the {relation} of the person being searched.</td>
</tr>
<tr>
<td>{relation}FamilyName</td>
<td>The family name of the {relation} of the person being searched.</td>
</tr>
<tr>
<td>{relation}BirthDate</td>

<td>The birth date of the {relation} of the person being searched.</td>
</tr>
<tr>
<td>{relation}BirthPlace</td>
<td>The birth place of the {relation} of the person being searched.</td>
</tr>
<tr>
<td>{relation}DeathDate</td>
<td>The death date of the {relation} of the person being searched.</td>
</tr>
<tr>
<td>{relation}DeathPlace</td>

<td>The death place of the {relation} of the person being searched.</td>
</tr>
<tr>
<td>{relation}MarriageDate</td>
<td>The marriage date of the {relation} of the person being searched.</td>
</tr>
<tr>
<td>{relation}MarriagePlace</td>
<td>The marriage place of the {relation} of the person being searched.</td>
</tr>
</table>

## Properties

      <table>
        <tr>
          <td align="right">Name:</td>
          <td>Search</td>
        </tr>
        <tr>
          <td align="right">Namespace:</td>

          <td>http://gedcomx.org/conclusion/v1/</td>
        </tr>
        <tr>
          <td align="right">Representation(s):</td>
          <td><a href="http://www.gedcomx.org/model/atom.html">feed</a></td>
        </tr>
        <tr>

          <td align="right">Subresources:</td>
          <td>SearchEntry</td>
        </tr>

      </table>

## Operations

### GET

Read the results of a search.

#### Status Codes

<table>
          <tr>
            <th align="center">code</th>
            <th align="center">condition</th>
          </tr>

          <tr>
            <td>200</td>
            <td>Upon a successful read.</td>
          </tr>
          <tr>
            <td>204</td>
            <td>Upon a successful query with no results.</td>

          </tr>
          <tr>
            <td>400</td>
            <td>If the query to be processed was unable to be understood by the application.</td>
          </tr>
          <tr>
            <td>413</td>

            <td>If the application declines to process the query because it would have resulted in too many results.</td>
          </tr>
        </table>