{"action":"created","comment":{"url":"https://api.github.com/repos/pa11y/pa11y.github.io/pulls/comments/64601236","id":64601236,"diff_hunk":"@@ -17,27 +17,38 @@ Hello, so you're interested in helping out with our communications? We're pretty\n \n ## Writing Style\n \n-We don't have _strict_ guidelines on how you should write. We're not going to attempt to remove your personality from your writing. This brings us onto a first key point:\n+We don't have _strict_ guidelines on how you should write. We're not going to attempt to remove your personality from your writing. We have two sets of guidlines - Tone of Voice and Plain English. \n \n-### Write Like a Human...\n \n-Be professional, yes, but also conversational. We don't want to sound like robots, and should certainly never be communicating on behalf of the Pa11y project in unfeeling business-speak. At all times our users should feel like they're talking to a regular human.\n-\n-### ...But a Nice Human\n+### Tone of Voice Guidelines\n \n+- Write like a human  \n+Be professional, yes, but also conversational. We don't want to sound like robots, and should certainly never be communicating on behalf of the Pa11y project in unfeeling business-speak. At all times our users should feel like they're talking to a regular human.","path":"contributing/communications.md","position":15,"original_position":15,"commit_id":"07c8d3b0d44b894da2a71767d0b74d06172af604","original_commit_id":"07c8d3b0d44b894da2a71767d0b74d06172af604","user":{"login":"rowanmanning","id":138944,"avatar_url":"https://avatars.githubusercontent.com/u/138944?v=3","gravatar_id":"","url":"https://api.github.com/users/rowanmanning","html_url":"https://github.com/rowanmanning","followers_url":"https://api.github.com/users/rowanmanning/followers","following_url":"https://api.github.com/users/rowanmanning/following{/other_user}","gists_url":"https://api.github.com/users/rowanmanning/gists{/gist_id}","starred_url":"https://api.github.com/users/rowanmanning/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/rowanmanning/subscriptions","organizations_url":"https://api.github.com/users/rowanmanning/orgs","repos_url":"https://api.github.com/users/rowanmanning/repos","events_url":"https://api.github.com/users/rowanmanning/events{/privacy}","received_events_url":"https://api.github.com/users/rowanmanning/received_events","type":"User","site_admin":false},"body":"I notice you're using single line breaks here. I'm afraid they don't work :( oddly they render locally but when you push to GitHub pages they don't.\r\n\r\nI've been using headings in lists for this, not sure whether it's correct or not but it works. [E.g. here](https://github.com/pa11y/pa11y.github.io/commit/71bad37160496cfb0965db7cc033d58c0f9a6797#diff-414a1a0a980a16f36003309fa914c17dR44)","created_at":"2016-05-25T16:04:09Z","updated_at":"2016-05-25T16:04:09Z","html_url":"https://github.com/pa11y/pa11y.github.io/pull/26#discussion_r64601236","pull_request_url":"https://api.github.com/repos/pa11y/pa11y.github.io/pulls/26","_links":{"self":{"href":"https://api.github.com/repos/pa11y/pa11y.github.io/pulls/comments/64601236"},"html":{"href":"https://github.com/pa11y/pa11y.github.io/pull/26#discussion_r64601236"},"pull_request":{"href":"https://api.github.com/repos/pa11y/pa11y.github.io/pulls/26"}}},"pull_request":{"url":"https://api.github.com/repos/pa11y/pa11y.github.io/pulls/26","id":71416968,"html_url":"https://github.com/pa11y/pa11y.github.io/pull/26","diff_url":"https://github.com/pa11y/pa11y.github.io/pull/26.diff","patch_url":"https://github.com/pa11y/pa11y.github.io/pull/26.patch","issue_url":"https://api.github.com/repos/pa11y/pa11y.github.io/issues/26","number":26,"state":"open","locked":false,"title":"first attempt at writing style overhaul","user":{"login":"hollsk","id":1948361,"avatar_url":"https://avatars.githubusercontent.com/u/1948361?v=3","gravatar_id":"","url":"https://api.github.com/users/hollsk","html_url":"https://github.com/hollsk","followers_url":"https://api.github.com/users/hollsk/followers","following_url":"https://api.github.com/users/hollsk/following{/other_user}","gists_url":"https://api.github.com/users/hollsk/gists{/gist_id}","starred_url":"https://api.github.com/users/hollsk/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/hollsk/subscriptions","organizations_url":"https://api.github.com/users/hollsk/orgs","repos_url":"https://api.github.com/users/hollsk/repos","events_url":"https://api.github.com/users/hollsk/events{/privacy}","received_events_url":"https://api.github.com/users/hollsk/received_events","type":"User","site_admin":false},"body":"Input requested :-)\r\n\r\nI've tried to keep it concise, but there may be things missed out. Perhaps there are specific guidelines for _technical_ writing I don't know of? @typothecary ?","created_at":"2016-05-25T15:55:58Z","updated_at":"2016-05-25T16:04:09Z","closed_at":null,"merged_at":null,"merge_commit_sha":"8c3ede92cf7f4082da62eb83c31d113ea176758a","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/pa11y/pa11y.github.io/pulls/26/commits","review_comments_url":"https://api.github.com/repos/pa11y/pa11y.github.io/pulls/26/comments","review_comment_url":"https://api.github.com/repos/pa11y/pa11y.github.io/pulls/comments{/number}","comments_url":"https://api.github.com/repos/pa11y/pa11y.github.io/issues/26/comments","statuses_url":"https://api.github.com/repos/pa11y/pa11y.github.io/statuses/07c8d3b0d44b894da2a71767d0b74d06172af604","head":{"label":"pa11y:writing-style","ref":"writing-style","sha":"07c8d3b0d44b894da2a71767d0b74d06172af604","user":{"login":"pa11y","id":16292300,"avatar_url":"https://avatars.githubusercontent.com/u/16292300?v=3","gravatar_id":"","url":"https://api.github.com/users/pa11y","html_url":"https://github.com/pa11y","followers_url":"https://api.github.com/users/pa11y/followers","following_url":"https://api.github.com/users/pa11y/following{/other_user}","gists_url":"https://api.github.com/users/pa11y/gists{/gist_id}","starred_url":"https://api.github.com/users/pa11y/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/pa11y/subscriptions","organizations_url":"https://api.github.com/users/pa11y/orgs","repos_url":"https://api.github.com/users/pa11y/repos","events_url":"https://api.github.com/users/pa11y/events{/privacy}","received_events_url":"https://api.github.com/users/pa11y/received_events","type":"Organization","site_admin":false},"repo":{"id":58489412,"name":"pa11y.github.io","full_name":"pa11y/pa11y.github.io","owner":{"login":"pa11y","id":16292300,"avatar_url":"https://avatars.githubusercontent.com/u/16292300?v=3","gravatar_id":"","url":"https://api.github.com/users/pa11y","html_url":"https://github.com/pa11y","followers_url":"https://api.github.com/users/pa11y/followers","following_url":"https://api.github.com/users/pa11y/following{/other_user}","gists_url":"https://api.github.com/users/pa11y/gists{/gist_id}","starred_url":"https://api.github.com/users/pa11y/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/pa11y/subscriptions","organizations_url":"https://api.github.com/users/pa11y/orgs","repos_url":"https://api.github.com/users/pa11y/repos","events_url":"https://api.github.com/users/pa11y/events{/privacy}","received_events_url":"https://api.github.com/users/pa11y/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/pa11y/pa11y.github.io","description":"The new Pa11y website","fork":false,"url":"https://api.github.com/repos/pa11y/pa11y.github.io","forks_url":"https://api.github.com/repos/pa11y/pa11y.github.io/forks","keys_url":"https://api.github.com/repos/pa11y/pa11y.github.io/keys{/key_id}","collaborators_url":"https://api.github.com/repos/pa11y/pa11y.github.io/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/pa11y/pa11y.github.io/teams","hooks_url":"https://api.github.com/repos/pa11y/pa11y.github.io/hooks","issue_events_url":"https://api.github.com/repos/pa11y/pa11y.github.io/issues/events{/number}","events_url":"https://api.github.com/repos/pa11y/pa11y.github.io/events","assignees_url":"https://api.github.com/repos/pa11y/pa11y.github.io/assignees{/user}","branches_url":"https://api.github.com/repos/pa11y/pa11y.github.io/branches{/branch}","tags_url":"https://api.github.com/repos/pa11y/pa11y.github.io/tags","blobs_url":"https://api.github.com/repos/pa11y/pa11y.github.io/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/pa11y/pa11y.github.io/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/pa11y/pa11y.github.io/git/refs{/sha}","trees_url":"https://api.github.com/repos/pa11y/pa11y.github.io/git/trees{/sha}","statuses_url":"https://api.github.com/repos/pa11y/pa11y.github.io/statuses/{sha}","languages_url":"https://api.github.com/repos/pa11y/pa11y.github.io/languages","stargazers_url":"https://api.github.com/repos/pa11y/pa11y.github.io/stargazers","contributors_url":"https://api.github.com/repos/pa11y/pa11y.github.io/contributors","subscribers_url":"https://api.github.com/repos/pa11y/pa11y.github.io/subscribers","subscription_url":"https://api.github.com/repos/pa11y/pa11y.github.io/subscription","commits_url":"https://api.github.com/repos/pa11y/pa11y.github.io/commits{/sha}","git_commits_url":"https://api.github.com/repos/pa11y/pa11y.github.io/git/commits{/sha}","comments_url":"https://api.github.com/repos/pa11y/pa11y.github.io/comments{/number}","issue_comment_url":"https://api.github.com/repos/pa11y/pa11y.github.io/issues/comments{/number}","contents_url":"https://api.github.com/repos/pa11y/pa11y.github.io/contents/{+path}","compare_url":"https://api.github.com/repos/pa11y/pa11y.github.io/compare/{base}...{head}","merges_url":"https://api.github.com/repos/pa11y/pa11y.github.io/merges","archive_url":"https://api.github.com/repos/pa11y/pa11y.github.io/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/pa11y/pa11y.github.io/downloads","issues_url":"https://api.github.com/repos/pa11y/pa11y.github.io/issues{/number}","pulls_url":"https://api.github.com/repos/pa11y/pa11y.github.io/pulls{/number}","milestones_url":"https://api.github.com/repos/pa11y/pa11y.github.io/milestones{/number}","notifications_url":"https://api.github.com/repos/pa11y/pa11y.github.io/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/pa11y/pa11y.github.io/labels{/name}","releases_url":"https://api.github.com/repos/pa11y/pa11y.github.io/releases{/id}","deployments_url":"https://api.github.com/repos/pa11y/pa11y.github.io/deployments","created_at":"2016-05-10T19:51:45Z","updated_at":"2016-05-25T14:38:38Z","pushed_at":"2016-05-25T15:55:59Z","git_url":"git://github.com/pa11y/pa11y.github.io.git","ssh_url":"git@github.com:pa11y/pa11y.github.io.git","clone_url":"https://github.com/pa11y/pa11y.github.io.git","svn_url":"https://github.com/pa11y/pa11y.github.io","homepage":"http://pa11y.github.io/","size":98,"stargazers_count":2,"watchers_count":2,"language":"HTML","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":true,"forks_count":2,"mirror_url":null,"open_issues_count":5,"forks":2,"open_issues":5,"watchers":2,"default_branch":"master"}},"base":{"label":"pa11y:master","ref":"master","sha":"572c3b5c427b71318f257b0909ff1c184f2ca2b4","user":{"login":"pa11y","id":16292300,"avatar_url":"https://avatars.githubusercontent.com/u/16292300?v=3","gravatar_id":"","url":"https://api.github.com/users/pa11y","html_url":"https://github.com/pa11y","followers_url":"https://api.github.com/users/pa11y/followers","following_url":"https://api.github.com/users/pa11y/following{/other_user}","gists_url":"https://api.github.com/users/pa11y/gists{/gist_id}","starred_url":"https://api.github.com/users/pa11y/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/pa11y/subscriptions","organizations_url":"https://api.github.com/users/pa11y/orgs","repos_url":"https://api.github.com/users/pa11y/repos","events_url":"https://api.github.com/users/pa11y/events{/privacy}","received_events_url":"https://api.github.com/users/pa11y/received_events","type":"Organization","site_admin":false},"repo":{"id":58489412,"name":"pa11y.github.io","full_name":"pa11y/pa11y.github.io","owner":{"login":"pa11y","id":16292300,"avatar_url":"https://avatars.githubusercontent.com/u/16292300?v=3","gravatar_id":"","url":"https://api.github.com/users/pa11y","html_url":"https://github.com/pa11y","followers_url":"https://api.github.com/users/pa11y/followers","following_url":"https://api.github.com/users/pa11y/following{/other_user}","gists_url":"https://api.github.com/users/pa11y/gists{/gist_id}","starred_url":"https://api.github.com/users/pa11y/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/pa11y/subscriptions","organizations_url":"https://api.github.com/users/pa11y/orgs","repos_url":"https://api.github.com/users/pa11y/repos","events_url":"https://api.github.com/users/pa11y/events{/privacy}","received_events_url":"https://api.github.com/users/pa11y/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/pa11y/pa11y.github.io","description":"The new Pa11y website","fork":false,"url":"https://api.github.com/repos/pa11y/pa11y.github.io","forks_url":"https://api.github.com/repos/pa11y/pa11y.github.io/forks","keys_url":"https://api.github.com/repos/pa11y/pa11y.github.io/keys{/key_id}","collaborators_url":"https://api.github.com/repos/pa11y/pa11y.github.io/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/pa11y/pa11y.github.io/teams","hooks_url":"https://api.github.com/repos/pa11y/pa11y.github.io/hooks","issue_events_url":"https://api.github.com/repos/pa11y/pa11y.github.io/issues/events{/number}","events_url":"https://api.github.com/repos/pa11y/pa11y.github.io/events","assignees_url":"https://api.github.com/repos/pa11y/pa11y.github.io/assignees{/user}","branches_url":"https://api.github.com/repos/pa11y/pa11y.github.io/branches{/branch}","tags_url":"https://api.github.com/repos/pa11y/pa11y.github.io/tags","blobs_url":"https://api.github.com/repos/pa11y/pa11y.github.io/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/pa11y/pa11y.github.io/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/pa11y/pa11y.github.io/git/refs{/sha}","trees_url":"https://api.github.com/repos/pa11y/pa11y.github.io/git/trees{/sha}","statuses_url":"https://api.github.com/repos/pa11y/pa11y.github.io/statuses/{sha}","languages_url":"https://api.github.com/repos/pa11y/pa11y.github.io/languages","stargazers_url":"https://api.github.com/repos/pa11y/pa11y.github.io/stargazers","contributors_url":"https://api.github.com/repos/pa11y/pa11y.github.io/contributors","subscribers_url":"https://api.github.com/repos/pa11y/pa11y.github.io/subscribers","subscription_url":"https://api.github.com/repos/pa11y/pa11y.github.io/subscription","commits_url":"https://api.github.com/repos/pa11y/pa11y.github.io/commits{/sha}","git_commits_url":"https://api.github.com/repos/pa11y/pa11y.github.io/git/commits{/sha}","comments_url":"https://api.github.com/repos/pa11y/pa11y.github.io/comments{/number}","issue_comment_url":"https://api.github.com/repos/pa11y/pa11y.github.io/issues/comments{/number}","contents_url":"https://api.github.com/repos/pa11y/pa11y.github.io/contents/{+path}","compare_url":"https://api.github.com/repos/pa11y/pa11y.github.io/compare/{base}...{head}","merges_url":"https://api.github.com/repos/pa11y/pa11y.github.io/merges","archive_url":"https://api.github.com/repos/pa11y/pa11y.github.io/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/pa11y/pa11y.github.io/downloads","issues_url":"https://api.github.com/repos/pa11y/pa11y.github.io/issues{/number}","pulls_url":"https://api.github.com/repos/pa11y/pa11y.github.io/pulls{/number}","milestones_url":"https://api.github.com/repos/pa11y/pa11y.github.io/milestones{/number}","notifications_url":"https://api.github.com/repos/pa11y/pa11y.github.io/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/pa11y/pa11y.github.io/labels{/name}","releases_url":"https://api.github.com/repos/pa11y/pa11y.github.io/releases{/id}","deployments_url":"https://api.github.com/repos/pa11y/pa11y.github.io/deployments","created_at":"2016-05-10T19:51:45Z","updated_at":"2016-05-25T14:38:38Z","pushed_at":"2016-05-25T15:55:59Z","git_url":"git://github.com/pa11y/pa11y.github.io.git","ssh_url":"git@github.com:pa11y/pa11y.github.io.git","clone_url":"https://github.com/pa11y/pa11y.github.io.git","svn_url":"https://github.com/pa11y/pa11y.github.io","homepage":"http://pa11y.github.io/","size":98,"stargazers_count":2,"watchers_count":2,"language":"HTML","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":true,"forks_count":2,"mirror_url":null,"open_issues_count":5,"forks":2,"open_issues":5,"watchers":2,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/pa11y/pa11y.github.io/pulls/26"},"html":{"href":"https://github.com/pa11y/pa11y.github.io/pull/26"},"issue":{"href":"https://api.github.com/repos/pa11y/pa11y.github.io/issues/26"},"comments":{"href":"https://api.github.com/repos/pa11y/pa11y.github.io/issues/26/comments"},"review_comments":{"href":"https://api.github.com/repos/pa11y/pa11y.github.io/pulls/26/comments"},"review_comment":{"href":"https://api.github.com/repos/pa11y/pa11y.github.io/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/pa11y/pa11y.github.io/pulls/26/commits"},"statuses":{"href":"https://api.github.com/repos/pa11y/pa11y.github.io/statuses/07c8d3b0d44b894da2a71767d0b74d06172af604"}}}}
{"actor":{"display_login":"rowanmanning"}}