Merge pull request github#349 from github/search-updates

izuzak · izuzak · commit 30bdb1c0d7ea · 2013-11-08T09:43:17.000-08:00
Update Search API documentation on search qualifiers
diff --git a/content/changes/2013-10-18-new-code-search-requirements.md b/content/changes/2013-10-18-new-code-search-requirements.md
@@ -18,17 +18,17 @@ The value must include [at least one user, organization, or repository][search-b
 
 For example, with this query, we're searching for code from [@twitter][] or [@facebook][] that uses an MIT License:
 
-    MIT License @twitter @facebook
+    MIT License user:twitter user:facebook
 
 And here, we're looking for uses of the underscore library in [@mozilla's BrowserQuest][@mozilla/BrowserQuest] repository:
 
-    underscore language:js @mozilla/BrowserQuest
+    underscore language:js repo:mozilla/BrowserQuest
 
 To perform these queries via the API, we would use the following URLs (respectively):
 
-    https://api.github.com/search/code?q=MIT+License+%40twitter+%40facebook
+    https://api.github.com/search/code?q=MIT+License+user%3Atwitter+user%3Afacebook
 
-    https://api.github.com/search/code?q=underscore+language%3Ajs+%40mozilla%2FBrowserQuest
+    https://api.github.com/search/code?q=underscore+language%3Ajs+repo%3Amozilla%2FBrowserQuest
 
 All the various [code search qualifiers][code-search-qualifiers] are still available to you.
 A [user, organization, or repository qualifier][search-by-user-org-repo] is now required.
diff --git a/content/v3/search.md b/content/v3/search.md
@@ -145,11 +145,11 @@ Suppose you want to find the definition of the `addClass` function inside
 [jQuery](https://github.com/jquery/jquery). Your query would look something like
 this:
 
-    https://api.github.com/search/code?q=addClass+in:file+language:js+@jquery/jquery
+    https://api.github.com/search/code?q=addClass+in:file+language:js+repo:jquery/jquery
 
 Here, we're searching for the keyword `addClass` within a file's contents. We're
 making sure that we're only looking in files where the language is JavaScript.
-And we're scoping the search to the `@jquery/jquery` repository.
+And we're scoping the search to the `repo:jquery/jquery` repository.
 
 <%= headers 200 %>
 <%= json(:code_search_v3_results) %>
@@ -163,7 +163,7 @@ media type in your Accept header. For example, via curl, the above query would
 look like this:
 
     curl -H 'Accept: application/vnd.github.v3.text-match+json' \
-      https://api.github.com/search/code?q=addClass+in:file+language:js+@jquery/jquery
+      https://api.github.com/search/code?q=addClass+in:file+language:js+repo:jquery/jquery
 
 This produces the same JSON payload as above, with an extra key called
 `text_matches`, an array of objects. These objects provide information such as
@@ -198,6 +198,11 @@ q
      Finds issues that are assigned to a certain user.
    * [Mentions](https://help.github.com/articles/searching-issues#mentions)
      Finds issues that mention a certain user.
+   * [Commenter](https://help.github.com/articles/searching-issues#commenter)
+     Finds issues that a certain user commented on.
+   * [Involves](https://help.github.com/articles/searching-issues#involves)
+     Finds issues that were either created by a certain user, assigned to that
+     user, mention that user, or were commented on by that user.
    * [State](https://help.github.com/articles/searching-issues#state)
      Filter issues based on whether they're open or closed.
    * [Labels](https://help.github.com/articles/searching-issues#labels)
