{"action":"created","comment":{"url":"https://api.github.com/repos/elementary/website/pulls/comments/81809856","pull_request_review_id":2761088,"id":81809856,"diff_hunk":"@@ -266,64 +266,64 @@ For more info, see the FreeDesktop.Org [menu entry](http://standards.freedesktop\n \n You may also include keywords in your launcher to help users find your app via search. These follow the convention of \"X-GNOME-Keywords\" (for in the app launcher) and \"X-AppInstall-Keywords\" (for in the app installer). For example, web browser might include \"Internet\" as a keyword even though it's not in the app's name, generic name, or description. As a result, a user searching for \"Internet\" will find the app. Here are some more examples:\n \n-* Geary: **Email;Gmail**\n+* Mail: **Email;Gmail**\n * Midori: **Internet;WWW;Explorer**\n * Files: **Folders;Browser;Explorer;Finder;Manager**\n * Terminal: **Command;Prompt;cmd;Emulator**\n * Scratch: **Notepad;IDE;Plain**\n * System Settings: **Control;Panel**\n * Shotwell: **Camera;Picture**\n \n-Keywords should be single words in [title case](#title-case) and seperated with a semicolon.\n+Keywords should be single words (in [title case](#title-case)) separated by semicolons.\n \n --------------------------------------\n \n See also: [Desktop Entry Specification](http://standards.freedesktop.org/desktop-entry-spec/latest/index.html) from FreeDesktop.org\n \n ## Contractor {#contractor}\n \n-Contractor is a service and a protocol for exposing services easily between apps. It allows an app to interact with various other apps/services without hardcoding support for them. You simply add [contractor](https://launchpad.net/contractor) support, and then any service registered with contractor is now available for your app to use. Your app can integrate with contractor in two different ways:\n+Contractor is a service and a protocol for exposing services easily between apps. It lets apps interact with other apps and services in lieu of hardcoded support. You simply add [Contractor](https://launchpad.net/contractor) support, and then any service registered with Contractor is now available for your app to use. Your app can integrate with Contractor in two different ways:\n \n-* Register one of it's functions as a service that can be used from other apps\n+* Register one of its functions as a service that can be used from other apps\n * Implement the contractor menu or otherwise access contractor to receive a list of services that can handle the data your app manages\n \n ### Displaying Results from Contractor {#displaying-results-from-contractor}\n \n-The most typical way to present Contractor results to users is in menu form. Keep in mind the following things when presenting contractor results:\n+Contractor results are typically presented to users in menu form. Keep the following in mind when presenting Contractor results:\n \n * If the item acted upon is one of many items visible, such as in an icon view, be sure to display results in a way that is directly related to the item such as in a context menu.\n * If the item acted upon is the only item currently visible, such as a web page or a contact in Dexter, contractor can be displayed in a toolbar menu.\n * Never display the target app's name. The menu string is the intended display name for that app. Doing so can lead to redundant messages such as, \"Set image as wallpaper (wallpaper)\" and it is always irrelevant to a user's needs.\n \n ## Dock Integration {#dock-integration}\n \n-By integration with Pantheon's dock, apps are able to communicate their status to the user at a glance.\n+Apps integrated with Pantheon's dock communicate their status to the user at a glance.\n \n ![](/images/docs/human-interface-guidelines/dock-integration/dock.png)\n \n ### Progressbars {#progressbars}\n \n-A progressbar must be unambiguous in its use, referring to a single specific task. For example, a progressbar can be used to indicate the status of a file transfer or of a lengthy process like encoding. A progressbar should not be used to compound the progress of multiple types of actions.\n+Make progress bars unambiguous by referring to a single, specific task. For example, use progress bars to indicate the status of lengthy processes like file transfers and encoding. Do not use progress bars to compound the progress of different types of action.\n \n-* **Good Example**: Installation progress in Software Center\n+* **Good Example**: Installation progress in AppCenter\n * **Bad Example**: Combined progress of downloading an album, burning a CD, and syncing a mobile device in Noise\n \n ### Badges {#badges}\n \n-A badge shows a count of actionable items which your app manages. It's purpose is to inform the user that there are items that require user attention or action without being obtrusive. This is a passive notification. A badge should not show totals or rarely changing counters. If the badge is not easily dismissed when the user views your app, it is likely that this is not a good use of a badge.\n+A badge shows a count of actionable items managed by your app. Its purpose is to inform the user that there are items that require user attention or action without being obtrusive. This is a passive notification. A badge should not show totals or rarely changing counters. If the badge is not easily dismissed when the user views your app, it is likely that this is not a good use of a badge.\n \n-* **Good Example**: Unread messages in Geary\n+* **Good Example**: Unread messages in Mail\n * **Bad Example**: Total number of Photos in Shotwell\n \n ## System Indicators {#system-indicators}\n \n-Indicators are small icons that live on the top panel. They give users a place to glance for a quick indication of various settings or events. Clicking the icon shows a small menu with related actions available to the user.\n+Indicators are small icons that live in the menu bar (wingpanel). They give users a place to glance for a quick indication of various settings or events. Clicking the icon shows a small menu with related actions available to the user.\n \n ![](/images/docs/human-interface-guidelines/system-indicators/systray.png)\n \n-### Does Your App Need An Indicator? {#does-your-app-need-an-indicator}\n+### Does Your App Need an Indicator? {#does-your-app-need-an-indicator}\n \n-The indicator area is notorious for becoming cluttered and having inconsistent behavior. Given that users will probably install many third party apps, we need to be careful about how many indicators we're showing and how they behave. Keep in mind that not every application needs an indicator. Only a very small set of apps will benefit from one. You do not need an indicator if:\n+The indicator area is notorious for clutter and inconsistent behavior. Given that users will probably install many third-party apps, we must be careful about the number of indicators we show and how they behave. Keep in mind that not every application needs an indicator. Only a very small set of apps will benefit from one. You do not need an indicator if:","path":"docs/human-interface-guidelines.md","position":163,"original_position":163,"commit_id":"837d78eb0cdd62da8c944e73176d580afd517ac7","original_commit_id":"837d78eb0cdd62da8c944e73176d580afd517ac7","user":{"login":"danrabbit","id":7277719,"avatar_url":"https://avatars.githubusercontent.com/u/7277719?v=3","gravatar_id":"","url":"https://api.github.com/users/danrabbit","html_url":"https://github.com/danrabbit","followers_url":"https://api.github.com/users/danrabbit/followers","following_url":"https://api.github.com/users/danrabbit/following{/other_user}","gists_url":"https://api.github.com/users/danrabbit/gists{/gist_id}","starred_url":"https://api.github.com/users/danrabbit/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/danrabbit/subscriptions","organizations_url":"https://api.github.com/users/danrabbit/orgs","repos_url":"https://api.github.com/users/danrabbit/repos","events_url":"https://api.github.com/users/danrabbit/events{/privacy}","received_events_url":"https://api.github.com/users/danrabbit/received_events","type":"User","site_admin":false},"body":"I think \"becoming cluttered\" is necessary because in its default state it is not cluttered. It only becomes cluttered when users install apps that overuse it.","created_at":"2016-10-04T17:27:57Z","updated_at":"2016-10-04T17:39:50Z","html_url":"https://github.com/elementary/website/pull/1430#discussion_r81809856","pull_request_url":"https://api.github.com/repos/elementary/website/pulls/1430","_links":{"self":{"href":"https://api.github.com/repos/elementary/website/pulls/comments/81809856"},"html":{"href":"https://github.com/elementary/website/pull/1430#discussion_r81809856"},"pull_request":{"href":"https://api.github.com/repos/elementary/website/pulls/1430"}}},"pull_request":{"url":"https://api.github.com/repos/elementary/website/pulls/1430","id":87860989,"html_url":"https://github.com/elementary/website/pull/1430","diff_url":"https://github.com/elementary/website/pull/1430.diff","patch_url":"https://github.com/elementary/website/pull/1430.patch","issue_url":"https://api.github.com/repos/elementary/website/issues/1430","number":1430,"state":"open","locked":false,"title":"cursory typos, concision, clarity","user":{"login":"owcz","id":778011,"avatar_url":"https://avatars.githubusercontent.com/u/778011?v=3","gravatar_id":"","url":"https://api.github.com/users/owcz","html_url":"https://github.com/owcz","followers_url":"https://api.github.com/users/owcz/followers","following_url":"https://api.github.com/users/owcz/following{/other_user}","gists_url":"https://api.github.com/users/owcz/gists{/gist_id}","starred_url":"https://api.github.com/users/owcz/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/owcz/subscriptions","organizations_url":"https://api.github.com/users/owcz/orgs","repos_url":"https://api.github.com/users/owcz/repos","events_url":"https://api.github.com/users/owcz/events{/privacy}","received_events_url":"https://api.github.com/users/owcz/received_events","type":"User","site_admin":false},"body":"### Changes Summary\r\n\r\nOnly changed what I thought was the most egregious as I read. Rarely ever a need to use \"allow\" instead of \"let\", or \"utilize\" instead of \"use\". Happy to help more if wanted\r\n\r\nThis pull request is ready for review.","created_at":"2016-10-04T09:36:35Z","updated_at":"2016-10-04T17:39:50Z","closed_at":null,"merged_at":null,"merge_commit_sha":"1239693f5a4f539205f626fd963dbff48c2c1703","assignee":null,"assignees":[],"milestone":null,"commits_url":"https://api.github.com/repos/elementary/website/pulls/1430/commits","review_comments_url":"https://api.github.com/repos/elementary/website/pulls/1430/comments","review_comment_url":"https://api.github.com/repos/elementary/website/pulls/comments{/number}","comments_url":"https://api.github.com/repos/elementary/website/issues/1430/comments","statuses_url":"https://api.github.com/repos/elementary/website/statuses/837d78eb0cdd62da8c944e73176d580afd517ac7","head":{"label":"owcz:patch-2","ref":"patch-2","sha":"837d78eb0cdd62da8c944e73176d580afd517ac7","user":{"login":"owcz","id":778011,"avatar_url":"https://avatars.githubusercontent.com/u/778011?v=3","gravatar_id":"","url":"https://api.github.com/users/owcz","html_url":"https://github.com/owcz","followers_url":"https://api.github.com/users/owcz/followers","following_url":"https://api.github.com/users/owcz/following{/other_user}","gists_url":"https://api.github.com/users/owcz/gists{/gist_id}","starred_url":"https://api.github.com/users/owcz/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/owcz/subscriptions","organizations_url":"https://api.github.com/users/owcz/orgs","repos_url":"https://api.github.com/users/owcz/repos","events_url":"https://api.github.com/users/owcz/events{/privacy}","received_events_url":"https://api.github.com/users/owcz/received_events","type":"User","site_admin":false},"repo":{"id":69530822,"name":"website-1","full_name":"owcz/website-1","owner":{"login":"owcz","id":778011,"avatar_url":"https://avatars.githubusercontent.com/u/778011?v=3","gravatar_id":"","url":"https://api.github.com/users/owcz","html_url":"https://github.com/owcz","followers_url":"https://api.github.com/users/owcz/followers","following_url":"https://api.github.com/users/owcz/following{/other_user}","gists_url":"https://api.github.com/users/owcz/gists{/gist_id}","starred_url":"https://api.github.com/users/owcz/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/owcz/subscriptions","organizations_url":"https://api.github.com/users/owcz/orgs","repos_url":"https://api.github.com/users/owcz/repos","events_url":"https://api.github.com/users/owcz/events{/privacy}","received_events_url":"https://api.github.com/users/owcz/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/owcz/website-1","description":"The elementary.io website","fork":true,"url":"https://api.github.com/repos/owcz/website-1","forks_url":"https://api.github.com/repos/owcz/website-1/forks","keys_url":"https://api.github.com/repos/owcz/website-1/keys{/key_id}","collaborators_url":"https://api.github.com/repos/owcz/website-1/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/owcz/website-1/teams","hooks_url":"https://api.github.com/repos/owcz/website-1/hooks","issue_events_url":"https://api.github.com/repos/owcz/website-1/issues/events{/number}","events_url":"https://api.github.com/repos/owcz/website-1/events","assignees_url":"https://api.github.com/repos/owcz/website-1/assignees{/user}","branches_url":"https://api.github.com/repos/owcz/website-1/branches{/branch}","tags_url":"https://api.github.com/repos/owcz/website-1/tags","blobs_url":"https://api.github.com/repos/owcz/website-1/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/owcz/website-1/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/owcz/website-1/git/refs{/sha}","trees_url":"https://api.github.com/repos/owcz/website-1/git/trees{/sha}","statuses_url":"https://api.github.com/repos/owcz/website-1/statuses/{sha}","languages_url":"https://api.github.com/repos/owcz/website-1/languages","stargazers_url":"https://api.github.com/repos/owcz/website-1/stargazers","contributors_url":"https://api.github.com/repos/owcz/website-1/contributors","subscribers_url":"https://api.github.com/repos/owcz/website-1/subscribers","subscription_url":"https://api.github.com/repos/owcz/website-1/subscription","commits_url":"https://api.github.com/repos/owcz/website-1/commits{/sha}","git_commits_url":"https://api.github.com/repos/owcz/website-1/git/commits{/sha}","comments_url":"https://api.github.com/repos/owcz/website-1/comments{/number}","issue_comment_url":"https://api.github.com/repos/owcz/website-1/issues/comments{/number}","contents_url":"https://api.github.com/repos/owcz/website-1/contents/{+path}","compare_url":"https://api.github.com/repos/owcz/website-1/compare/{base}...{head}","merges_url":"https://api.github.com/repos/owcz/website-1/merges","archive_url":"https://api.github.com/repos/owcz/website-1/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/owcz/website-1/downloads","issues_url":"https://api.github.com/repos/owcz/website-1/issues{/number}","pulls_url":"https://api.github.com/repos/owcz/website-1/pulls{/number}","milestones_url":"https://api.github.com/repos/owcz/website-1/milestones{/number}","notifications_url":"https://api.github.com/repos/owcz/website-1/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/owcz/website-1/labels{/name}","releases_url":"https://api.github.com/repos/owcz/website-1/releases{/id}","deployments_url":"https://api.github.com/repos/owcz/website-1/deployments","created_at":"2016-09-29T04:31:02Z","updated_at":"2016-09-29T04:31:14Z","pushed_at":"2016-10-04T09:35:08Z","git_url":"git://github.com/owcz/website-1.git","ssh_url":"git@github.com:owcz/website-1.git","clone_url":"https://github.com/owcz/website-1.git","svn_url":"https://github.com/owcz/website-1","homepage":"https://elementary.io","size":69733,"stargazers_count":0,"watchers_count":0,"language":"PHP","has_issues":false,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":0,"mirror_url":null,"open_issues_count":0,"forks":0,"open_issues":0,"watchers":0,"default_branch":"master"}},"base":{"label":"elementary:master","ref":"master","sha":"4d9d9c94cc06787708cf8802ae867e94868a2693","user":{"login":"elementary","id":1978534,"avatar_url":"https://avatars.githubusercontent.com/u/1978534?v=3","gravatar_id":"","url":"https://api.github.com/users/elementary","html_url":"https://github.com/elementary","followers_url":"https://api.github.com/users/elementary/followers","following_url":"https://api.github.com/users/elementary/following{/other_user}","gists_url":"https://api.github.com/users/elementary/gists{/gist_id}","starred_url":"https://api.github.com/users/elementary/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/elementary/subscriptions","organizations_url":"https://api.github.com/users/elementary/orgs","repos_url":"https://api.github.com/users/elementary/repos","events_url":"https://api.github.com/users/elementary/events{/privacy}","received_events_url":"https://api.github.com/users/elementary/received_events","type":"Organization","site_admin":false},"repo":{"id":28882452,"name":"website","full_name":"elementary/website","owner":{"login":"elementary","id":1978534,"avatar_url":"https://avatars.githubusercontent.com/u/1978534?v=3","gravatar_id":"","url":"https://api.github.com/users/elementary","html_url":"https://github.com/elementary","followers_url":"https://api.github.com/users/elementary/followers","following_url":"https://api.github.com/users/elementary/following{/other_user}","gists_url":"https://api.github.com/users/elementary/gists{/gist_id}","starred_url":"https://api.github.com/users/elementary/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/elementary/subscriptions","organizations_url":"https://api.github.com/users/elementary/orgs","repos_url":"https://api.github.com/users/elementary/repos","events_url":"https://api.github.com/users/elementary/events{/privacy}","received_events_url":"https://api.github.com/users/elementary/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/elementary/website","description":"The elementary.io website","fork":false,"url":"https://api.github.com/repos/elementary/website","forks_url":"https://api.github.com/repos/elementary/website/forks","keys_url":"https://api.github.com/repos/elementary/website/keys{/key_id}","collaborators_url":"https://api.github.com/repos/elementary/website/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/elementary/website/teams","hooks_url":"https://api.github.com/repos/elementary/website/hooks","issue_events_url":"https://api.github.com/repos/elementary/website/issues/events{/number}","events_url":"https://api.github.com/repos/elementary/website/events","assignees_url":"https://api.github.com/repos/elementary/website/assignees{/user}","branches_url":"https://api.github.com/repos/elementary/website/branches{/branch}","tags_url":"https://api.github.com/repos/elementary/website/tags","blobs_url":"https://api.github.com/repos/elementary/website/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/elementary/website/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/elementary/website/git/refs{/sha}","trees_url":"https://api.github.com/repos/elementary/website/git/trees{/sha}","statuses_url":"https://api.github.com/repos/elementary/website/statuses/{sha}","languages_url":"https://api.github.com/repos/elementary/website/languages","stargazers_url":"https://api.github.com/repos/elementary/website/stargazers","contributors_url":"https://api.github.com/repos/elementary/website/contributors","subscribers_url":"https://api.github.com/repos/elementary/website/subscribers","subscription_url":"https://api.github.com/repos/elementary/website/subscription","commits_url":"https://api.github.com/repos/elementary/website/commits{/sha}","git_commits_url":"https://api.github.com/repos/elementary/website/git/commits{/sha}","comments_url":"https://api.github.com/repos/elementary/website/comments{/number}","issue_comment_url":"https://api.github.com/repos/elementary/website/issues/comments{/number}","contents_url":"https://api.github.com/repos/elementary/website/contents/{+path}","compare_url":"https://api.github.com/repos/elementary/website/compare/{base}...{head}","merges_url":"https://api.github.com/repos/elementary/website/merges","archive_url":"https://api.github.com/repos/elementary/website/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/elementary/website/downloads","issues_url":"https://api.github.com/repos/elementary/website/issues{/number}","pulls_url":"https://api.github.com/repos/elementary/website/pulls{/number}","milestones_url":"https://api.github.com/repos/elementary/website/milestones{/number}","notifications_url":"https://api.github.com/repos/elementary/website/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/elementary/website/labels{/name}","releases_url":"https://api.github.com/repos/elementary/website/releases{/id}","deployments_url":"https://api.github.com/repos/elementary/website/deployments","created_at":"2015-01-06T20:39:35Z","updated_at":"2016-10-01T01:27:50Z","pushed_at":"2016-10-04T09:36:35Z","git_url":"git://github.com/elementary/website.git","ssh_url":"git@github.com:elementary/website.git","clone_url":"https://github.com/elementary/website.git","svn_url":"https://github.com/elementary/website","homepage":"https://elementary.io","size":195484,"stargazers_count":483,"watchers_count":483,"language":"PHP","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":300,"mirror_url":null,"open_issues_count":70,"forks":300,"open_issues":70,"watchers":483,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/elementary/website/pulls/1430"},"html":{"href":"https://github.com/elementary/website/pull/1430"},"issue":{"href":"https://api.github.com/repos/elementary/website/issues/1430"},"comments":{"href":"https://api.github.com/repos/elementary/website/issues/1430/comments"},"review_comments":{"href":"https://api.github.com/repos/elementary/website/pulls/1430/comments"},"review_comment":{"href":"https://api.github.com/repos/elementary/website/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/elementary/website/pulls/1430/commits"},"statuses":{"href":"https://api.github.com/repos/elementary/website/statuses/837d78eb0cdd62da8c944e73176d580afd517ac7"}}}}
{"actor":{"display_login":"danrabbit"}}