From f3fab080f9d27c6be309c41f9cf63f6fe8672557 Mon Sep 17 00:00:00 2001
From: Brendan Forster <brendan@github.com>
Date: Sun, 19 Jul 2015 08:42:14 +0930
Subject: [PATCH] tweaks

---
 docs/search.md | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/docs/search.md b/docs/search.md
index 4024f79b..19970f9e 100644
--- a/docs/search.md
+++ b/docs/search.md
@@ -10,11 +10,10 @@ on the GitHub or GitHub Enterprise server:
 
 ## Search Issues
 
-You can search for issues containing a given phrase across many
-repositories:
+A common scenario is to search for issues to triage:
 
 ```csharp
-// searching without specifying a term
+// you can also specify a search term here
 var request = new SearchIssuesRequest();
 
 // you should focus your search to a specific repo
@@ -63,7 +62,7 @@ request.State = ItemState.All;
 request.State = ItemState.Closed;
 ```
 
-And there's other options available for how the results are returned:
+There's other options available to control how the results are returned:
 
 ```csharp
 request.SortField = IssueSearchSort.Created;