{"action":"created","issue":{"url":"https://api.github.com/repos/w3c/wcag21/issues/307","repository_url":"https://api.github.com/repos/w3c/wcag21","labels_url":"https://api.github.com/repos/w3c/wcag21/issues/307/labels{/name}","comments_url":"https://api.github.com/repos/w3c/wcag21/issues/307/comments","events_url":"https://api.github.com/repos/w3c/wcag21/issues/307/events","html_url":"https://github.com/w3c/wcag21/issues/307","id":244029081,"number":307,"title":"Problem with Technique G131","user":{"login":"awkawk","id":4228257,"avatar_url":"https://avatars1.githubusercontent.com/u/4228257?v=4","gravatar_id":"","url":"https://api.github.com/users/awkawk","html_url":"https://github.com/awkawk","followers_url":"https://api.github.com/users/awkawk/followers","following_url":"https://api.github.com/users/awkawk/following{/other_user}","gists_url":"https://api.github.com/users/awkawk/gists{/gist_id}","starred_url":"https://api.github.com/users/awkawk/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/awkawk/subscriptions","organizations_url":"https://api.github.com/users/awkawk/orgs","repos_url":"https://api.github.com/users/awkawk/repos","events_url":"https://api.github.com/users/awkawk/events{/privacy}","received_events_url":"https://api.github.com/users/awkawk/received_events","type":"User","site_admin":false},"labels":[{"id":690349863,"url":"https://api.github.com/repos/w3c/wcag21/labels/AGWG%20Work%20item","name":"AGWG Work item","color":"c5def5","default":false},{"id":554408062,"url":"https://api.github.com/repos/w3c/wcag21/labels/Public%20Comment","name":"Public Comment","color":"b60205","default":false}],"state":"open","locked":false,"assignee":{"login":"jake-abma","id":6384002,"avatar_url":"https://avatars1.githubusercontent.com/u/6384002?v=4","gravatar_id":"","url":"https://api.github.com/users/jake-abma","html_url":"https://github.com/jake-abma","followers_url":"https://api.github.com/users/jake-abma/followers","following_url":"https://api.github.com/users/jake-abma/following{/other_user}","gists_url":"https://api.github.com/users/jake-abma/gists{/gist_id}","starred_url":"https://api.github.com/users/jake-abma/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jake-abma/subscriptions","organizations_url":"https://api.github.com/users/jake-abma/orgs","repos_url":"https://api.github.com/users/jake-abma/repos","events_url":"https://api.github.com/users/jake-abma/events{/privacy}","received_events_url":"https://api.github.com/users/jake-abma/received_events","type":"User","site_admin":false},"assignees":[{"login":"jake-abma","id":6384002,"avatar_url":"https://avatars1.githubusercontent.com/u/6384002?v=4","gravatar_id":"","url":"https://api.github.com/users/jake-abma","html_url":"https://github.com/jake-abma","followers_url":"https://api.github.com/users/jake-abma/followers","following_url":"https://api.github.com/users/jake-abma/following{/other_user}","gists_url":"https://api.github.com/users/jake-abma/gists{/gist_id}","starred_url":"https://api.github.com/users/jake-abma/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jake-abma/subscriptions","organizations_url":"https://api.github.com/users/jake-abma/orgs","repos_url":"https://api.github.com/users/jake-abma/repos","events_url":"https://api.github.com/users/jake-abma/events{/privacy}","received_events_url":"https://api.github.com/users/jake-abma/received_events","type":"User","site_admin":false}],"milestone":null,"comments":35,"created_at":"2017-07-19T12:49:11Z","updated_at":"2017-11-10T06:52:50Z","closed_at":null,"author_association":"MEMBER","body":"Summary of Issue: Use of the term \"required\" is ambiguous in Step 2 of G131 Test Procedure\r\nComment (Including rationale for any proposed change):\r\nIn reviewing the Sufficient Techniques for WCAG 2.0 SC 3.3.2, it's unclear to me what is intended by the use of the word \"required\" in step 2 of the Test Procedure for Technique G131: Providing descriptive labels.\r\n\r\nG131 Test Procedure Step 2 currently reads: \"Check that any required label is present.\"\r\n\r\nIn this context, was \"required label\" intended to mean:\r\nA) a visible text (or text symbol or icon with text equivalent) indicator that user input in the field is mandatory/required OR\r\nB) the type of user interface control/component requires a visible label separate from the control itself OR\r\nC) both A and B?\r\n\r\nRationale for Option A: Not all UI components require a separate label. A toggle <button> would not need/require a separate label (e.g., <label> element, title attribute or aria labeling technique) since the authored contents between the starting <button> element and closing </button> element can serve as the visible label for the component. In contrast, 2 input text fields would require a visible label to convey to the user what input they should to include in one text field versus the other text field.\r\n\r\nRationale for Option B: The introduction to the G131 technique has a sentence that indicates a required field indicator MAY be included in the label but nothing explicitly states that the label for UI components MUST distinguish whether input in a field is required or optional.\r\n\r\nProposed Change:\r\nChange G131's Test Procedure to clarify the intent of Step 2 and possibly add a fourth Step related to including a cue in the visible label to distinguish the fields for which user input is mandatory vs. optional.\r\n\r\nOne possible revision follows below:\r\nProcedure\r\n\r\nFor each interface component in the content:\r\n1. Identify the purpose of the interface component.\r\n2. Check that a label [linked to WCAG 2.0 definition for \"label\"] is visible for the component.\r\n3. Check that the label makes the component's purpose clear.\r\n4. If the user interface includes both mandatory and optional input, check that the visible label includes text or a text symbol that allows users to identify the components that require user input.\r\n"},"comment":{"url":"https://api.github.com/repos/w3c/wcag21/issues/comments/343389647","html_url":"https://github.com/w3c/wcag21/issues/307#issuecomment-343389647","issue_url":"https://api.github.com/repos/w3c/wcag21/issues/307","id":343389647,"user":{"login":"jake-abma","id":6384002,"avatar_url":"https://avatars1.githubusercontent.com/u/6384002?v=4","gravatar_id":"","url":"https://api.github.com/users/jake-abma","html_url":"https://github.com/jake-abma","followers_url":"https://api.github.com/users/jake-abma/followers","following_url":"https://api.github.com/users/jake-abma/following{/other_user}","gists_url":"https://api.github.com/users/jake-abma/gists{/gist_id}","starred_url":"https://api.github.com/users/jake-abma/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jake-abma/subscriptions","organizations_url":"https://api.github.com/users/jake-abma/orgs","repos_url":"https://api.github.com/users/jake-abma/repos","events_url":"https://api.github.com/users/jake-abma/events{/privacy}","received_events_url":"https://api.github.com/users/jake-abma/received_events","type":"User","site_admin":false},"created_at":"2017-11-10T06:52:50Z","updated_at":"2017-11-10T06:52:50Z","author_association":"NONE","body":"NEW PROPOSAL:\r\n------------------------------------------\r\n\r\n**Procedure**\r\n\r\nFor each interface component in the content:\r\n\r\n1. Identify its purpose.\r\n2. Check that it has an associated label.\r\n3. Check that the label makes the component's purpose clear.\r\n\r\n**Expected Results**\r\n\r\nChecks `#2` and `#3` are true.\r\n\r\n------------------------------------------"}}
{"actor":{"display_login":"jake-abma"}}