{"action":"created","issue":{"url":"https://api.github.com/repos/w3c/wai-quick-start/issues/314","repository_url":"https://api.github.com/repos/w3c/wai-quick-start","labels_url":"https://api.github.com/repos/w3c/wai-quick-start/issues/314/labels{/name}","comments_url":"https://api.github.com/repos/w3c/wai-quick-start/issues/314/comments","events_url":"https://api.github.com/repos/w3c/wai-quick-start/issues/314/events","html_url":"https://github.com/w3c/wai-quick-start/issues/314","id":172766495,"number":314,"title":"Use of the terms \"user story\"","user":{"login":"dboudreau","id":1852205,"avatar_url":"https://avatars.githubusercontent.com/u/1852205?v=3","gravatar_id":"","url":"https://api.github.com/users/dboudreau","html_url":"https://github.com/dboudreau","followers_url":"https://api.github.com/users/dboudreau/followers","following_url":"https://api.github.com/users/dboudreau/following{/other_user}","gists_url":"https://api.github.com/users/dboudreau/gists{/gist_id}","starred_url":"https://api.github.com/users/dboudreau/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dboudreau/subscriptions","organizations_url":"https://api.github.com/users/dboudreau/orgs","repos_url":"https://api.github.com/users/dboudreau/repos","events_url":"https://api.github.com/users/dboudreau/events{/privacy}","received_events_url":"https://api.github.com/users/dboudreau/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":7,"created_at":"2016-08-23T18:04:02Z","updated_at":"2016-09-05T11:37:00Z","closed_at":null,"body":"After having given it some thought, I am uncomfortable with using the terms \"user stories\" in our quick tips to link to the content from the \"How people use the Web\" resource. I would be in favor of changing \"User story\" to \"Persona\", which I think is much closer to what we're conveying, here. While these are stories about users, that particular term has been deviated from its original meaning in Agile to mean the description of a requirement, based on the expectation of a person using the site/app/software/etc.\r\n\r\nIn most designers' and developers' minds nowadays, the expectation of a user story is likely to be related to a very high-level definition of a requirement or a feature, in the form of \"as a [x], I want/need [y], so that I can [z]\". This is not what we're providing here. I think it's misleading, and I think we'D be better of avoiding that confusion if we can.\r\n\r\nSo this a global proposal to replace \"User story\" by \"Persona\", on every tip that links to one:\r\n\r\n## Designing\r\n- https://www.w3.org/WAI/gettingstarted/tips/designing.html#provide-sufficient-contrast-between-foreground-and-background\r\n- https://www.w3.org/WAI/gettingstarted/tips/designing.html#dont-use-color-alone-to-convey-information\r\n- https://www.w3.org/WAI/gettingstarted/tips/designing.html#ensure-that-interactive-elements-are-easy-to-identify\r\n- https://www.w3.org/WAI/gettingstarted/tips/designing.html#provide-clear-and-consistent-navigation-options\r\n- https://www.w3.org/WAI/gettingstarted/tips/designing.html#ensure-that-form-elements-include-clearly-associated-labels\r\n- https://www.w3.org/WAI/gettingstarted/tips/designing.html#provide-easily-identifiable-feedback\r\n- https://www.w3.org/WAI/gettingstarted/tips/designing.html#use-headings-and-spacing-to-group-related-content\r\n- https://www.w3.org/WAI/gettingstarted/tips/designing.html#create-designs-for-different-viewport-sizes\r\n- https://www.w3.org/WAI/gettingstarted/tips/designing.html#include-image-and-media-alternatives-in-your-design\r\n\r\n## Developing\r\n- https://www.w3.org/WAI/gettingstarted/tips/developing.html#include-alternative-text-for-images\r\n- https://www.w3.org/WAI/gettingstarted/tips/developing.html#use-mark-up-to-convey-meaning-and-structure\r\n- https://www.w3.org/WAI/gettingstarted/tips/developing.html#help-users-avoid-and-correct-mistakes\r\n- https://www.w3.org/WAI/gettingstarted/tips/developing.html#write-code-that-adapts-to-the-users-technology\r\n- https://www.w3.org/WAI/gettingstarted/tips/developing.html#ensure-that-all-interactive-elements-are-keyboard-accessible\r\n\r\n## Writing\r\n- https://www.w3.org/WAI/gettingstarted/tips/writing.html#use-headings-to-convey-meaning-and-structure\r\n- https://www.w3.org/WAI/gettingstarted/tips/writing.html#write-meaningful-text-alternatives-for-images\r\n- https://www.w3.org/WAI/gettingstarted/tips/writing.html#create-transcripts-and-captions-for-multimedia\r\n- https://www.w3.org/WAI/gettingstarted/tips/writing.html#provide-clear-instructions\r\n- https://www.w3.org/WAI/gettingstarted/tips/writing.html#keep-content-clear-and-concise"},"comment":{"url":"https://api.github.com/repos/w3c/wai-quick-start/issues/comments/244726327","html_url":"https://github.com/w3c/wai-quick-start/issues/314#issuecomment-244726327","issue_url":"https://api.github.com/repos/w3c/wai-quick-start/issues/314","id":244726327,"user":{"login":"dboudreau","id":1852205,"avatar_url":"https://avatars.githubusercontent.com/u/1852205?v=3","gravatar_id":"","url":"https://api.github.com/users/dboudreau","html_url":"https://github.com/dboudreau","followers_url":"https://api.github.com/users/dboudreau/followers","following_url":"https://api.github.com/users/dboudreau/following{/other_user}","gists_url":"https://api.github.com/users/dboudreau/gists{/gist_id}","starred_url":"https://api.github.com/users/dboudreau/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dboudreau/subscriptions","organizations_url":"https://api.github.com/users/dboudreau/orgs","repos_url":"https://api.github.com/users/dboudreau/repos","events_url":"https://api.github.com/users/dboudreau/events{/privacy}","received_events_url":"https://api.github.com/users/dboudreau/received_events","type":"User","site_admin":false},"created_at":"2016-09-05T11:37:00Z","updated_at":"2016-09-05T11:37:00Z","body":"@nitedog I hear you. I'm not really concerned with scope creep for something like this, though. I know we tend to discuss this for a long time, but those user stories would only be one sentence long, and for the most part. pretty straightforward. As an example, the user story for the first tip in design could be something along the lines of: \"As a person who is color blind, I want sufficient contrasts between foreground and background colors, so I can easily perceive content\". Just a little something to contextualize the tips, and help people understand why they should care."}}
{"actor":{"display_login":"dboudreau"}}