{"action":"created","issue":{"url":"https://api.github.com/repos/NYTimes/objective-c-style-guide/issues/114","labels_url":"https://api.github.com/repos/NYTimes/objective-c-style-guide/issues/114/labels{/name}","comments_url":"https://api.github.com/repos/NYTimes/objective-c-style-guide/issues/114/comments","events_url":"https://api.github.com/repos/NYTimes/objective-c-style-guide/issues/114/events","html_url":"https://github.com/NYTimes/objective-c-style-guide/pull/114","id":68763068,"number":114,"title":"Adopt RFC 2119 (MUST/SHOULD/MAY/... wording)","user":{"login":"loganmoseley","id":377298,"avatar_url":"https://avatars.githubusercontent.com/u/377298?v=3","gravatar_id":"","url":"https://api.github.com/users/loganmoseley","html_url":"https://github.com/loganmoseley","followers_url":"https://api.github.com/users/loganmoseley/followers","following_url":"https://api.github.com/users/loganmoseley/following{/other_user}","gists_url":"https://api.github.com/users/loganmoseley/gists{/gist_id}","starred_url":"https://api.github.com/users/loganmoseley/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/loganmoseley/subscriptions","organizations_url":"https://api.github.com/users/loganmoseley/orgs","repos_url":"https://api.github.com/users/loganmoseley/repos","events_url":"https://api.github.com/users/loganmoseley/events{/privacy}","received_events_url":"https://api.github.com/users/loganmoseley/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":2,"created_at":"2015-04-15T19:02:04Z","updated_at":"2015-07-24T22:57:27Z","closed_at":null,"pull_request":{"url":"https://api.github.com/repos/NYTimes/objective-c-style-guide/pulls/114","html_url":"https://github.com/NYTimes/objective-c-style-guide/pull/114","diff_url":"https://github.com/NYTimes/objective-c-style-guide/pull/114.diff","patch_url":"https://github.com/NYTimes/objective-c-style-guide/pull/114.patch"},"body":"## Before\r\n\r\nAs the style guide stands, I am not always sure on which side of the \"required\" line each style falls. I did not think we would have specifically been asked to follow the guide for ~6 requirements, though I could have been wrong. I was working under the presumption that the overwhelmingly used \"should\" was the polite way to say \"must.\" I am told that is not the intent.\r\n\r\n## After\r\n\r\nI would like to remove this ambiguity by formally adopting [RFC 2119](https://www.ietf.org/rfc/rfc2119.txt), which defines the specific words to be used for requirements, recommendations, and options. All statements have translated directly to RFC 2119 language. Any incorrect translations are mistakes, not ninjas, and MAY be altered. Also, the wording MAY be changed to match the working usage of the guide, either in this PR or another. Which words the guide ends up using is all at your discretion, maintainers! :+1: \r\n\r\n## Why\r\n\r\nAdopting RFC 2119 is a declaration that the guide has one unambiguous meaning.\r\n\r\n## For Reference\r\n\r\nThere appears to be a discrepancy between the totals of these numbers because the wording of the guide would, at times, use non-standard (in this list) forms of indicating requirements. In two words, more colloquial.\r\n\r\nBefore:\r\n- 39 should\r\n- 2 should always\r\n- 3 always\r\n- 1 must\r\n- 1 can\r\n\r\nAfter:\r\n- 22 MUST\r\n- 3 MUST NOT\r\n- 30 SHOULD, RECOMMENDED\r\n- 2 NOT RECOMMENDED\r\n- 5 MAY\r\n\r\nhttps://www.ietf.org/rfc/rfc2119.txt"},"comment":{"url":"https://api.github.com/repos/NYTimes/objective-c-style-guide/issues/comments/124757661","html_url":"https://github.com/NYTimes/objective-c-style-guide/pull/114#issuecomment-124757661","issue_url":"https://api.github.com/repos/NYTimes/objective-c-style-guide/issues/114","id":124757661,"user":{"login":"loganmoseley","id":377298,"avatar_url":"https://avatars.githubusercontent.com/u/377298?v=3","gravatar_id":"","url":"https://api.github.com/users/loganmoseley","html_url":"https://github.com/loganmoseley","followers_url":"https://api.github.com/users/loganmoseley/followers","following_url":"https://api.github.com/users/loganmoseley/following{/other_user}","gists_url":"https://api.github.com/users/loganmoseley/gists{/gist_id}","starred_url":"https://api.github.com/users/loganmoseley/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/loganmoseley/subscriptions","organizations_url":"https://api.github.com/users/loganmoseley/orgs","repos_url":"https://api.github.com/users/loganmoseley/repos","events_url":"https://api.github.com/users/loganmoseley/events{/privacy}","received_events_url":"https://api.github.com/users/loganmoseley/received_events","type":"User","site_admin":false},"created_at":"2015-07-24T22:57:27Z","updated_at":"2015-07-24T22:57:27Z","body":"@mattbischoff Resolved."}}