changed as per review

src/_data/rest_api.json

@@ -103,10 +103,10 @@
         "vehicles-for-agency": {
             "description": "get active vehicles for an agency"
         },
-        "search (stop)": {
+        "search-stop": {
             "description": "helps to find the stops based on the name/keywords"
         },
-        "search (route)": {
+        "search-route": {
             "description": "helps to find the routes based on the name/keywords"
         }
     },

src/api/where/methods/search-route.md

@@ -0,0 +1,17 @@
+---
+layout: rest_api
+title: Search-Route Method
+description: Search for a route based on its name.
+sample_request_url: https://api.pugetsound.onebusaway.org/api/where/search/route.json?input=crystal&key=TEST
+example_response_file: search_route_crystal.json
+---
+
+## Request Parameters
+
+* `input` - the string to search for, encoded directly in the URL:
+* `https://api.pugetsound.onebusaway.org/api/where/search/route.json?input=[INPUT GOES HERE]`
+* `maxCount` - the max number of results to return. Defaults to 20.
+
+## Response
+
+The method returns a [list result](/api/where/elements/list-result), so see additional documentation on controlling the number of elements returned and interpreting the results.  The list contents are `<route/>` elements, so see details about the various properties of the [`<route/>` element](/api/where/elements/route).

src/api/where/methods/search-stop.md

@@ -0,0 +1,17 @@
+---
+layout: rest_api
+title: Search-Stop Method
+description: Search for a stop based on its name.
+sample_request_url: https://api.pugetsound.onebusaway.org/api/where/search/stop.json?input=crystal&key=TEST
+example_response_file: search_stop_crystal.json
+---
+
+## Request Parameters
+
+* `input` - the string to search for, encoded directly in the URL:
+* `https://api.pugetsound.onebusaway.org/api/where/search/stop.json?input=[INPUT GOES HERE]`
+* `maxCount` - the max number of results to return. Defaults to 20.
+
+## Response
+
+The method returns a [list result](/api/where/elements/list-result), so see additional documentation on controlling the number of elements returned and interpreting the results.  The list contents are `<stop/>` elements, so see details about the various properties of the [`<stop/>` element](/api/where/elements/stop).

src/api/where/search/index.md

@@ -15,7 +15,7 @@ The Search API follows all the conventions of the RESTful API.
 
 ## Methods
 
-The current list of supported Search searches:
+The current list of supported Search are:
 
-* [stop](/api/where/methods/search (stop))
-* [route](/api/where/methods/search (route))
+* [stop](/api/where/methods/search-stop)
+* [route](/api/where/methods/search-route)