JavaLeaks
diff --git a/‎content/v3/search.md‎
Lines changed: 8 additions & 0 deletions b/‎content/v3/search.md‎
Lines changed: 8 additions & 0 deletions
diff --git a/‎lib/resources.rb‎
Lines changed: 7 additions & 6 deletions b/‎lib/resources.rb‎
Lines changed: 7 additions & 6 deletions
@@ -18,6 +18,14 @@ search results so that you can find the item that best meets your needs. To
 satisfy that need, the GitHub Search API provides **up to 1,000 results for each
 search**.
 
+### Ranking search results
+
+Unless another sort option is provided as a query parameter, results are sorted
+by best match, as indicated by the `score` field for each item returned. This
+is a computed value representing the relevance of a item relative to the other
+items in the result set. Multiple factors are combined to boost the most
+relevant item to the top of the result list.
+
 ### Rate limit
 
 The Search API has a custom rate limit. For requests using [Basic
 
@@ -1222,11 +1222,12 @@ def text_html(response, status, head = {})
     ]
 
     GIST_FILE = {
-      "size"     => 932,
-      "filename" => "ring.erl",
-      "raw_url"  => "https://gist.githubusercontent.com/raw/365370/8c4d2d43d178df44f4c03a7f2ac0ff512853564e/ring.erl",
-      "type"     => "text/plain",
-      "language" => "Erlang"
+      "ring.erl" => {
+        "size"     => 932,
+        "raw_url"  => "https://gist.githubusercontent.com/raw/365370/8c4d2d43d178df44f4c03a7f2ac0ff512853564e/ring.erl",
+        "type"     => "text/plain",
+        "language" => "Erlang"
+      }
     }
 
     GIST = {
@@ -1237,7 +1238,7 @@ def text_html(response, status, head = {})
       "description"  => "description of gist",
       "public"       => true,
       "user"         => USER,
-      "files"        => { "ring.erl" => GIST_FILE },
+      "files"        => GIST_FILE,
       "comments"     => 0,
       "comments_url" => "https://api.github.com/gists/#{SecureRandom.hex(10)}/comments/",
       "html_url"     => "https://gist.github.com/1",