{"action":"created","issue":{"url":"https://api.github.com/repos/raywenderlich/english-style-guide/issues/5","labels_url":"https://api.github.com/repos/raywenderlich/english-style-guide/issues/5/labels{/name}","comments_url":"https://api.github.com/repos/raywenderlich/english-style-guide/issues/5/comments","events_url":"https://api.github.com/repos/raywenderlich/english-style-guide/issues/5/events","html_url":"https://github.com/raywenderlich/english-style-guide/issues/5","id":98189717,"number":5,"title":"Misplaced Unity Guidelines","user":{"login":"greystar93","id":12779820,"avatar_url":"https://avatars.githubusercontent.com/u/12779820?v=3","gravatar_id":"","url":"https://api.github.com/users/greystar93","html_url":"https://github.com/greystar93","followers_url":"https://api.github.com/users/greystar93/followers","following_url":"https://api.github.com/users/greystar93/following{/other_user}","gists_url":"https://api.github.com/users/greystar93/gists{/gist_id}","starred_url":"https://api.github.com/users/greystar93/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/greystar93/subscriptions","organizations_url":"https://api.github.com/users/greystar93/orgs","repos_url":"https://api.github.com/users/greystar93/repos","events_url":"https://api.github.com/users/greystar93/events{/privacy}","received_events_url":"https://api.github.com/users/greystar93/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":2,"created_at":"2015-07-30T14:55:03Z","updated_at":"2015-08-31T16:08:51Z","closed_at":null,"body":"I question whether two of these guidelines belong in the English Style Guide:\r\n\r\n* **animated GIFs** Use animated GIFs only once for an operation. When repeating the operation, use either a screenshot or refer the reader back to the animated GIF. [Note: Changed gif to GIF, as per English Style Guide rule re: file extensions.]\r\n\r\n* **spoilers** Use spoilers to \"quiz\" readers on repeated operations in the tutorial.\r\n\r\nI would argue these are writing guidelines. In fact, there's a section on [animated GIFs](http://www.raywenderlich.com/tutorial-team/writing-guide-part-3) in the Writing Guide.\r\n\r\nI also wonder if these two guidelines can be applied to tutorials generally, not just to Unity tutorials? I think we need to move them somewhere, either to the Writing Guide or to a separate Unity guide.\r\n\r\n"},"comment":{"url":"https://api.github.com/repos/raywenderlich/english-style-guide/issues/comments/136416831","html_url":"https://github.com/raywenderlich/english-style-guide/issues/5#issuecomment-136416831","issue_url":"https://api.github.com/repos/raywenderlich/english-style-guide/issues/5","id":136416831,"user":{"login":"crispy8888","id":12776589,"avatar_url":"https://avatars.githubusercontent.com/u/12776589?v=3","gravatar_id":"","url":"https://api.github.com/users/crispy8888","html_url":"https://github.com/crispy8888","followers_url":"https://api.github.com/users/crispy8888/followers","following_url":"https://api.github.com/users/crispy8888/following{/other_user}","gists_url":"https://api.github.com/users/crispy8888/gists{/gist_id}","starred_url":"https://api.github.com/users/crispy8888/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/crispy8888/subscriptions","organizations_url":"https://api.github.com/users/crispy8888/orgs","repos_url":"https://api.github.com/users/crispy8888/repos","events_url":"https://api.github.com/users/crispy8888/events{/privacy}","received_events_url":"https://api.github.com/users/crispy8888/received_events","type":"User","site_admin":false},"created_at":"2015-08-31T16:08:51Z","updated_at":"2015-08-31T16:08:51Z","body":"@wlinc @greystar93 - serial comma note and examples have been added to the\nguide. It's a bit redundant, seeing as we already note adherence to AP\nstyle, but most authors wouldn't know that AP prescribes this style.\n\nOn the subject of menu navigation: echo whatever the casing is of the menu\nitem itself. If it's \"Open file...\" then use that. If it's \"Kill with FIRE\"\nthen use that.\n\nOn Monday, August 31, 2015, Wendy Lincoln <notifications@github.com> wrote:\n\n> Noting that we need to add an entry about using AP style commas as opposed\n> to Oxford/serial commas. @crispy8888 <https://github.com/crispy8888>\n> @greystar93 <https://github.com/greystar93>\n>\n> Other suggested entries: clarify formatting for menu navigation: Here \\ Go\n> Here \\ And Here \\ Choose This. I suggest we go with title case and space\n> between the backslashes, since that appears to be the go-to.\n>\n> There was something else I thought would be helpful to add, but it escapes\n> my memory.\n>\n> —\n> Reply to this email directly or view it on GitHub\n> <https://github.com/raywenderlich/english-style-guide/issues/5#issuecomment-136414109>\n> .\n>\n"}}