Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Draft guidance section on labeling and describing #74

Closed
10 tasks
mcking65 opened this issue Aug 12, 2016 · 3 comments
Closed
10 tasks

Draft guidance section on labeling and describing #74

mcking65 opened this issue Aug 12, 2016 · 3 comments
Assignees
@zcorpan
Labels
Practice Page Related to a page within the practices section of the APG
Milestone
1.1 APG Release 4

Comments

@mcking65
Copy link
Contributor

mcking65 commented Aug 12, 2016 •
edited
Loading

This section will cover the following:

For reference, content of a draft labeling and describing section from a very old APG working draft has been preserved here.
@mcking65 mcking65 modified the milestones: 1.1 APG Release 2, 1.1 PR Aug 12, 2016
@mcking65 mcking65 changed the title Draft section on labeling and describing Draft guidance section on labeling and describing Aug 13, 2016
mcking65 added a commit that referenced this issue Aug 14, 2016
@mcking65
Removed sections that require major rework to fix incorrect guidance.
eabf6ca 
In addition to the below, This commit also moves the landmark section after the example section.

Moved each of the following sections from aria-practices.html to aria-practices-DeletedSectionsArchive.html
and created associated issues for drafting new versions.
1. Section "General Steps for Building an Accessible Widget with WAI-ARIA" and created issue #73.
2. Section "Other Widget Authoring Practices"., primarily about aria-valuenow, there is no specific need to raise an issue for this section.
3. Section "Relationships" and raised issues #74, #75, #76, and #77.
4. Section "Managing Dynamic Changes" and created issue #78.
5. Section "Presentation Role" and created issue #79.
6. Section "Form Properties" and created issue #80.
7. Section "Drag-and-Drop Support" and created issue #81
8. Section "Math" and created issue #82.
9. Section "Reusable Component Libraries" and created issue #83.
10. The following 4 Appendix sections related to background on ARIA and created issue #84
A. Background on WAI-ARIA
B. Filling the Gaps for Content Delivered to Desktop Browsers
c. Building Accessible Applications with WAI-ARIA
D. Reasons for Adopting WAI-ARIA
11. The following design patterns:
A. Accordion and updated issue #53.
B. Autocomplete and updated issue #31.
C. Combobox and updated issue #31.
D. Datepicker and updated issue #57
E. Dialog (Non-Modal) and updated issue 59.
F. Dialog (Tooltip) and added issue #85.
G. Landmarks and added issue #86.
H. Popup Help (aka Bubble Help) and added issue #87.
I. Rich Text Editor and added issue #88.
j. Site Navigator - General and added issue #89.
K. Site Navigator - Tree and added it to issue #89.
L. Site Navigator - Tabbed Style and added it to issue #89.
M. Tree Grid and added issue #91.
N. Wizard and added issue #92.
@ZoeBijl ZoeBijl self-assigned this Aug 15, 2016
@ZoeBijl ZoeBijl modified the milestones: 1.1 Q4 PWD, 1.1 PR Aug 15, 2016
tatermelon pushed a commit to tatermelon/aria-practices that referenced this issue Aug 19, 2016
@mcking65 @tatermelon
Removed sections that require major rework to fix incorrect guidance.
572cdf3 
In addition to the below, This commit also moves the landmark section after the example section.

Moved each of the following sections from aria-practices.html to aria-practices-DeletedSectionsArchive.html
and created associated issues for drafting new versions.
1. Section "General Steps for Building an Accessible Widget with WAI-ARIA" and created issue w3c#73.
2. Section "Other Widget Authoring Practices"., primarily about aria-valuenow, there is no specific need to raise an issue for this section.
3. Section "Relationships" and raised issues w3c#74, w3c#75, w3c#76, and w3c#77.
4. Section "Managing Dynamic Changes" and created issue w3c#78.
5. Section "Presentation Role" and created issue w3c#79.
6. Section "Form Properties" and created issue w3c#80.
7. Section "Drag-and-Drop Support" and created issue w3c#81
8. Section "Math" and created issue w3c#82.
9. Section "Reusable Component Libraries" and created issue w3c#83.
10. The following 4 Appendix sections related to background on ARIA and created issue w3c#84
A. Background on WAI-ARIA
B. Filling the Gaps for Content Delivered to Desktop Browsers
c. Building Accessible Applications with WAI-ARIA
D. Reasons for Adopting WAI-ARIA
11. The following design patterns:
A. Accordion and updated issue w3c#53.
B. Autocomplete and updated issue w3c#31.
C. Combobox and updated issue w3c#31.
D. Datepicker and updated issue w3c#57
E. Dialog (Non-Modal) and updated issue 59.
F. Dialog (Tooltip) and added issue w3c#85.
G. Landmarks and added issue w3c#86.
H. Popup Help (aka Bubble Help) and added issue w3c#87.
I. Rich Text Editor and added issue w3c#88.
j. Site Navigator - General and added issue w3c#89.
K. Site Navigator - Tree and added it to issue w3c#89.
L. Site Navigator - Tabbed Style and added it to issue w3c#89.
M. Tree Grid and added issue w3c#91.
N. Wizard and added issue w3c#92.
@mcking65
Copy link
Contributor Author

In the August 25, 2016 ARIA call, there was discussion about creating a table of roles that shows for each:

  1. Name from author: yes/no
  2. Name from content: yes/no
  3. Name required: yes/no

Our labeling and describing section should explain, as simply as possible, what the various possible combinations of values for named from author and named from content mean.

One issue discussed in the ARIA call is that authors frequently label things that are named from content, which is unnecessary if the content provides a good label.

Shane has a script that could auto generate the table for our labeling and describing section.

@mcking65 mcking65 modified the milestones: 1.1 PR, 1.1 Q4 PWD Dec 8, 2016
@mcking65 mcking65 added documentation Practice Page Related to a page within the practices section of the APG labels Jan 19, 2017
@jnurthen
Copy link
Member

Include #651

@zcorpan zcorpan self-assigned this Feb 26, 2019
zcorpan added a commit that referenced this issue Feb 28, 2019
@zcorpan
Guideline for labeling and describing
de49b61 
Fixes #70, fixes #74.
@zcorpan zcorpan mentioned this issue Feb 28, 2019
Merged
zcorpan added a commit that referenced this issue Apr 29, 2019
@zcorpan
Guideline for labeling and describing
61f20ae 
Fixes #70, fixes #74.
mcking65 pushed a commit that referenced this issue Jun 28, 2019
@zcorpan @mcking65
Add section on accessible names and descriptions (pull #994)
37da361 
Addresses issues #70 and #74 by adding section 5: - providing accessible names and descriptions.
michael-n-cooper pushed a commit that referenced this issue Jun 28, 2019
Generated by TRAVIS-CI 37da361
d56164a 
Add section on accessible names and descriptions (pull #994)

Addresses issues #70 and #74 by adding section 5: - providing accessible names and descriptions.
@mcking65
Copy link
Contributor Author

Complete with commit 37da361.

The new section on providing accessible names and descriptions is now in the editor's draft.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees

@zcorpan zcorpan

Labels
Practice Page Related to a page within the practices section of the APG
Projects
None yet
Milestone
1.1 APG Release 4
Development

No branches or pull requests
4 participants
@zcorpan @jnurthen @ZoeBijl @mcking65