{"action":"created","comment":{"url":"https://api.github.com/repos/pelias/pelias-doc/pulls/comments/40547580","id":40547580,"diff_hunk":"@@ -90,19 +91,17 @@ Results in the United States:\n * YMCA, Bremerton, WA\n * YMCA, Westerly, RI\n \n-\n-### ...to a rectangular region\n+### Search within a rectangular region\n \n ![](https://github.com/dianashk/pelias-doc/blob/master/getting-started/world_rect.png)\n- \n-In the case where you need to specify the boundary using a rectangle, all we need is a pair of coordinates on earth. Here are a few examples:\n \n-#### Example time\n-Let's say you wanted to find museums in the state of **Texas**. You'd need to set the `boundary.rect.*` parameter grouping to values representing the bounding box around **Texas**: min_lon=-106.65 min_lat=25.84 max_lon=-93.51 max_lat=36.5\n+To specify the boundary using a rectangle, you need latitude, longitude coordinates for two corners of the bounding box (the mininum and the maximum latitude, longitude).\n+\n+For example, to find a YMCA within the state of Texas, you can set the `boundary.rect.*` parameter to values representing the bounding box around Texas: min_lon=-106.65 min_lat=25.84 max_lon=-93.51 max_lat=36.5\n \n-***PRO TIP:*** *You can lookup a bounding box for a known region [here](http://boundingbox.klokantech.com/)*\n+  Tip: You can look up a bounding box for a known region with this [web tool](http://boundingbox.klokantech.com/)*","path":"getting-started/002-search.md","position":95,"original_position":95,"commit_id":"b76752131b9b8660d1b1dca1ae33f9c175f84928","original_commit_id":"b76752131b9b8660d1b1dca1ae33f9c175f84928","user":{"login":"missinglink","id":738069,"avatar_url":"https://avatars.githubusercontent.com/u/738069?v=3","gravatar_id":"","url":"https://api.github.com/users/missinglink","html_url":"https://github.com/missinglink","followers_url":"https://api.github.com/users/missinglink/followers","following_url":"https://api.github.com/users/missinglink/following{/other_user}","gists_url":"https://api.github.com/users/missinglink/gists{/gist_id}","starred_url":"https://api.github.com/users/missinglink/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/missinglink/subscriptions","organizations_url":"https://api.github.com/users/missinglink/orgs","repos_url":"https://api.github.com/users/missinglink/repos","events_url":"https://api.github.com/users/missinglink/events{/privacy}","received_events_url":"https://api.github.com/users/missinglink/received_events","type":"User","site_admin":false},"body":"agh, we support none of the standards in that dropdown! I guess 'CSV RAW' is the nearest?","created_at":"2015-09-28T12:52:01Z","updated_at":"2015-09-28T12:52:01Z","html_url":"https://github.com/pelias/pelias-doc/pull/6#discussion_r40547580","pull_request_url":"https://api.github.com/repos/pelias/pelias-doc/pulls/6","_links":{"self":{"href":"https://api.github.com/repos/pelias/pelias-doc/pulls/comments/40547580"},"html":{"href":"https://github.com/pelias/pelias-doc/pull/6#discussion_r40547580"},"pull_request":{"href":"https://api.github.com/repos/pelias/pelias-doc/pulls/6"}}},"pull_request":{"url":"https://api.github.com/repos/pelias/pelias-doc/pulls/6","id":46110472,"html_url":"https://github.com/pelias/pelias-doc/pull/6","diff_url":"https://github.com/pelias/pelias-doc/pull/6.diff","patch_url":"https://github.com/pelias/pelias-doc/pull/6.patch","issue_url":"https://api.github.com/repos/pelias/pelias-doc/issues/6","number":6,"state":"open","locked":false,"title":"First pass through Search docs","user":{"login":"rmglennon","id":4380498,"avatar_url":"https://avatars.githubusercontent.com/u/4380498?v=3","gravatar_id":"","url":"https://api.github.com/users/rmglennon","html_url":"https://github.com/rmglennon","followers_url":"https://api.github.com/users/rmglennon/followers","following_url":"https://api.github.com/users/rmglennon/following{/other_user}","gists_url":"https://api.github.com/users/rmglennon/gists{/gist_id}","starred_url":"https://api.github.com/users/rmglennon/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/rmglennon/subscriptions","organizations_url":"https://api.github.com/users/rmglennon/orgs","repos_url":"https://api.github.com/users/rmglennon/repos","events_url":"https://api.github.com/users/rmglennon/events{/privacy}","received_events_url":"https://api.github.com/users/rmglennon/received_events","type":"User","site_admin":false},"body":"Main changes:\r\nFormatting updates to be more friendly to mkdocs pipeline\r\nVoice changes to match doc style\r\nMoved results from search topic to response topic\r\n\r\nTo do:\r\ndescription of the data sources used in Mapzen Search\r\nmore on layers - perhaps pull layers and data sources into a separate topic and link to it from the 002-search topic\r\nworking examples and API keys\r\nmore on the overview\r\n\r\nIf you don't want to merge this to master at this time, we can work off rhonda-doc-updates branch.\r\n\r\n---\r\nSome editing comments:\r\n- Make topic and section titles be Sentence case, using imperative verbs (such as “Getting Started with Mapzen Search” should be “Get started with Mapzen Search”)\r\n- Need a # (no == under titles) for the main title, and then ## or more for subheadings. Try to limit to ### levels to keep the table of contents simple.\r\n- Avoid using words like simple, easy, simply, or just. They are fillers that can make people feel badly or dumb when something goes wrong.\r\n- To tell people to insert their own API key, use `your-api-key`\r\n- Use second person (you), rather than we, in most contexts.\r\n- Avoid ellipses in titles, as they won’t work well in the table of contents and at the top of pages when you scroll. \r\n- Latitude,longitude (to match x,y)\r\n- One space after periods.\r\n- Is it neighborhood or neighbourhood? \r\n- Format json code blocks as json, rather than js.\r\n","created_at":"2015-09-27T22:31:10Z","updated_at":"2015-09-28T12:52:01Z","closed_at":null,"merged_at":null,"merge_commit_sha":"ab5052c96e9cc389685b97e4234f427576ec42f2","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/pelias/pelias-doc/pulls/6/commits","review_comments_url":"https://api.github.com/repos/pelias/pelias-doc/pulls/6/comments","review_comment_url":"https://api.github.com/repos/pelias/pelias-doc/pulls/comments{/number}","comments_url":"https://api.github.com/repos/pelias/pelias-doc/issues/6/comments","statuses_url":"https://api.github.com/repos/pelias/pelias-doc/statuses/b76752131b9b8660d1b1dca1ae33f9c175f84928","head":{"label":"pelias:rhonda-doc-updates","ref":"rhonda-doc-updates","sha":"b76752131b9b8660d1b1dca1ae33f9c175f84928","user":{"login":"pelias","id":8240367,"avatar_url":"https://avatars.githubusercontent.com/u/8240367?v=3","gravatar_id":"","url":"https://api.github.com/users/pelias","html_url":"https://github.com/pelias","followers_url":"https://api.github.com/users/pelias/followers","following_url":"https://api.github.com/users/pelias/following{/other_user}","gists_url":"https://api.github.com/users/pelias/gists{/gist_id}","starred_url":"https://api.github.com/users/pelias/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/pelias/subscriptions","organizations_url":"https://api.github.com/users/pelias/orgs","repos_url":"https://api.github.com/users/pelias/repos","events_url":"https://api.github.com/users/pelias/events{/privacy}","received_events_url":"https://api.github.com/users/pelias/received_events","type":"Organization","site_admin":false},"repo":{"id":35889900,"name":"pelias-doc","full_name":"pelias/pelias-doc","owner":{"login":"pelias","id":8240367,"avatar_url":"https://avatars.githubusercontent.com/u/8240367?v=3","gravatar_id":"","url":"https://api.github.com/users/pelias","html_url":"https://github.com/pelias","followers_url":"https://api.github.com/users/pelias/followers","following_url":"https://api.github.com/users/pelias/following{/other_user}","gists_url":"https://api.github.com/users/pelias/gists{/gist_id}","starred_url":"https://api.github.com/users/pelias/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/pelias/subscriptions","organizations_url":"https://api.github.com/users/pelias/orgs","repos_url":"https://api.github.com/users/pelias/repos","events_url":"https://api.github.com/users/pelias/events{/privacy}","received_events_url":"https://api.github.com/users/pelias/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/pelias/pelias-doc","description":"All things documentation for Pelias","fork":false,"url":"https://api.github.com/repos/pelias/pelias-doc","forks_url":"https://api.github.com/repos/pelias/pelias-doc/forks","keys_url":"https://api.github.com/repos/pelias/pelias-doc/keys{/key_id}","collaborators_url":"https://api.github.com/repos/pelias/pelias-doc/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/pelias/pelias-doc/teams","hooks_url":"https://api.github.com/repos/pelias/pelias-doc/hooks","issue_events_url":"https://api.github.com/repos/pelias/pelias-doc/issues/events{/number}","events_url":"https://api.github.com/repos/pelias/pelias-doc/events","assignees_url":"https://api.github.com/repos/pelias/pelias-doc/assignees{/user}","branches_url":"https://api.github.com/repos/pelias/pelias-doc/branches{/branch}","tags_url":"https://api.github.com/repos/pelias/pelias-doc/tags","blobs_url":"https://api.github.com/repos/pelias/pelias-doc/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/pelias/pelias-doc/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/pelias/pelias-doc/git/refs{/sha}","trees_url":"https://api.github.com/repos/pelias/pelias-doc/git/trees{/sha}","statuses_url":"https://api.github.com/repos/pelias/pelias-doc/statuses/{sha}","languages_url":"https://api.github.com/repos/pelias/pelias-doc/languages","stargazers_url":"https://api.github.com/repos/pelias/pelias-doc/stargazers","contributors_url":"https://api.github.com/repos/pelias/pelias-doc/contributors","subscribers_url":"https://api.github.com/repos/pelias/pelias-doc/subscribers","subscription_url":"https://api.github.com/repos/pelias/pelias-doc/subscription","commits_url":"https://api.github.com/repos/pelias/pelias-doc/commits{/sha}","git_commits_url":"https://api.github.com/repos/pelias/pelias-doc/git/commits{/sha}","comments_url":"https://api.github.com/repos/pelias/pelias-doc/comments{/number}","issue_comment_url":"https://api.github.com/repos/pelias/pelias-doc/issues/comments{/number}","contents_url":"https://api.github.com/repos/pelias/pelias-doc/contents/{+path}","compare_url":"https://api.github.com/repos/pelias/pelias-doc/compare/{base}...{head}","merges_url":"https://api.github.com/repos/pelias/pelias-doc/merges","archive_url":"https://api.github.com/repos/pelias/pelias-doc/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/pelias/pelias-doc/downloads","issues_url":"https://api.github.com/repos/pelias/pelias-doc/issues{/number}","pulls_url":"https://api.github.com/repos/pelias/pelias-doc/pulls{/number}","milestones_url":"https://api.github.com/repos/pelias/pelias-doc/milestones{/number}","notifications_url":"https://api.github.com/repos/pelias/pelias-doc/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/pelias/pelias-doc/labels{/name}","releases_url":"https://api.github.com/repos/pelias/pelias-doc/releases{/id}","created_at":"2015-05-19T15:10:43Z","updated_at":"2015-05-19T15:10:43Z","pushed_at":"2015-09-28T11:21:59Z","git_url":"git://github.com/pelias/pelias-doc.git","ssh_url":"git@github.com:pelias/pelias-doc.git","clone_url":"https://github.com/pelias/pelias-doc.git","svn_url":"https://github.com/pelias/pelias-doc","homepage":null,"size":219,"stargazers_count":0,"watchers_count":0,"language":null,"has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":3,"mirror_url":null,"open_issues_count":3,"forks":3,"open_issues":3,"watchers":0,"default_branch":"master"}},"base":{"label":"pelias:master","ref":"master","sha":"72604e5bcaaab079c5761570e1cb57965b8cdf40","user":{"login":"pelias","id":8240367,"avatar_url":"https://avatars.githubusercontent.com/u/8240367?v=3","gravatar_id":"","url":"https://api.github.com/users/pelias","html_url":"https://github.com/pelias","followers_url":"https://api.github.com/users/pelias/followers","following_url":"https://api.github.com/users/pelias/following{/other_user}","gists_url":"https://api.github.com/users/pelias/gists{/gist_id}","starred_url":"https://api.github.com/users/pelias/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/pelias/subscriptions","organizations_url":"https://api.github.com/users/pelias/orgs","repos_url":"https://api.github.com/users/pelias/repos","events_url":"https://api.github.com/users/pelias/events{/privacy}","received_events_url":"https://api.github.com/users/pelias/received_events","type":"Organization","site_admin":false},"repo":{"id":35889900,"name":"pelias-doc","full_name":"pelias/pelias-doc","owner":{"login":"pelias","id":8240367,"avatar_url":"https://avatars.githubusercontent.com/u/8240367?v=3","gravatar_id":"","url":"https://api.github.com/users/pelias","html_url":"https://github.com/pelias","followers_url":"https://api.github.com/users/pelias/followers","following_url":"https://api.github.com/users/pelias/following{/other_user}","gists_url":"https://api.github.com/users/pelias/gists{/gist_id}","starred_url":"https://api.github.com/users/pelias/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/pelias/subscriptions","organizations_url":"https://api.github.com/users/pelias/orgs","repos_url":"https://api.github.com/users/pelias/repos","events_url":"https://api.github.com/users/pelias/events{/privacy}","received_events_url":"https://api.github.com/users/pelias/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/pelias/pelias-doc","description":"All things documentation for Pelias","fork":false,"url":"https://api.github.com/repos/pelias/pelias-doc","forks_url":"https://api.github.com/repos/pelias/pelias-doc/forks","keys_url":"https://api.github.com/repos/pelias/pelias-doc/keys{/key_id}","collaborators_url":"https://api.github.com/repos/pelias/pelias-doc/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/pelias/pelias-doc/teams","hooks_url":"https://api.github.com/repos/pelias/pelias-doc/hooks","issue_events_url":"https://api.github.com/repos/pelias/pelias-doc/issues/events{/number}","events_url":"https://api.github.com/repos/pelias/pelias-doc/events","assignees_url":"https://api.github.com/repos/pelias/pelias-doc/assignees{/user}","branches_url":"https://api.github.com/repos/pelias/pelias-doc/branches{/branch}","tags_url":"https://api.github.com/repos/pelias/pelias-doc/tags","blobs_url":"https://api.github.com/repos/pelias/pelias-doc/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/pelias/pelias-doc/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/pelias/pelias-doc/git/refs{/sha}","trees_url":"https://api.github.com/repos/pelias/pelias-doc/git/trees{/sha}","statuses_url":"https://api.github.com/repos/pelias/pelias-doc/statuses/{sha}","languages_url":"https://api.github.com/repos/pelias/pelias-doc/languages","stargazers_url":"https://api.github.com/repos/pelias/pelias-doc/stargazers","contributors_url":"https://api.github.com/repos/pelias/pelias-doc/contributors","subscribers_url":"https://api.github.com/repos/pelias/pelias-doc/subscribers","subscription_url":"https://api.github.com/repos/pelias/pelias-doc/subscription","commits_url":"https://api.github.com/repos/pelias/pelias-doc/commits{/sha}","git_commits_url":"https://api.github.com/repos/pelias/pelias-doc/git/commits{/sha}","comments_url":"https://api.github.com/repos/pelias/pelias-doc/comments{/number}","issue_comment_url":"https://api.github.com/repos/pelias/pelias-doc/issues/comments{/number}","contents_url":"https://api.github.com/repos/pelias/pelias-doc/contents/{+path}","compare_url":"https://api.github.com/repos/pelias/pelias-doc/compare/{base}...{head}","merges_url":"https://api.github.com/repos/pelias/pelias-doc/merges","archive_url":"https://api.github.com/repos/pelias/pelias-doc/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/pelias/pelias-doc/downloads","issues_url":"https://api.github.com/repos/pelias/pelias-doc/issues{/number}","pulls_url":"https://api.github.com/repos/pelias/pelias-doc/pulls{/number}","milestones_url":"https://api.github.com/repos/pelias/pelias-doc/milestones{/number}","notifications_url":"https://api.github.com/repos/pelias/pelias-doc/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/pelias/pelias-doc/labels{/name}","releases_url":"https://api.github.com/repos/pelias/pelias-doc/releases{/id}","created_at":"2015-05-19T15:10:43Z","updated_at":"2015-05-19T15:10:43Z","pushed_at":"2015-09-28T11:21:59Z","git_url":"git://github.com/pelias/pelias-doc.git","ssh_url":"git@github.com:pelias/pelias-doc.git","clone_url":"https://github.com/pelias/pelias-doc.git","svn_url":"https://github.com/pelias/pelias-doc","homepage":null,"size":219,"stargazers_count":0,"watchers_count":0,"language":null,"has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":3,"mirror_url":null,"open_issues_count":3,"forks":3,"open_issues":3,"watchers":0,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/pelias/pelias-doc/pulls/6"},"html":{"href":"https://github.com/pelias/pelias-doc/pull/6"},"issue":{"href":"https://api.github.com/repos/pelias/pelias-doc/issues/6"},"comments":{"href":"https://api.github.com/repos/pelias/pelias-doc/issues/6/comments"},"review_comments":{"href":"https://api.github.com/repos/pelias/pelias-doc/pulls/6/comments"},"review_comment":{"href":"https://api.github.com/repos/pelias/pelias-doc/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/pelias/pelias-doc/pulls/6/commits"},"statuses":{"href":"https://api.github.com/repos/pelias/pelias-doc/statuses/b76752131b9b8660d1b1dca1ae33f9c175f84928"}}}}