Accessibility Minutes 2011 12 12

Present

Jon: Have started documenting some of the cache objects and methods. First is the DOMCache, and secondly the DOMElement cache.

Jon: DOMCache: Listing the properties and methods

Jon: What additional information or formatting changes are needed?

Nick: Would like to see concise example that illustrates common usage pattern (doesn't have to exercise every method).

Nick: Is it possible in the wiki to use definition list for parameters?

Nick: Additional suggestion: ordering the methods (alphabetical or by usage sequence)?

Prasanna: Would like to see parameter list with the method name.

Jon: None of the methods for DOMCache are public. The properties are the part of the API that tool builders would use.

Philip: May want to look at jsdoc-toolkit.

Nick: Will look at this more closely.

Nick: Example code cannot be auto-generated, but can be very useful.

Jon: Will focus more on example code for the API documentation; can be useful within our development group.

Jon: Let's go back and look at rulesets.

Jon: 2.4.6 is about headings and labels being meaningful.

Jon: Using headings is a AAA requirement

Jon: 3.3 Labels for Controls is a single A requirement

Jon: General question: Should the transitional ruleset intentionally avoid mentioning landmarks?

Jon: For example, HEADING 2 would need another rule, HEADING_2T (transitional); the two would be mutually exclusive.

Ann: There is no requirement in WCAG for headings to be unique.

Jon: One way to maximize descriptiveness is to make sure headings are not repeated over and over again.

Jon: In practice, not many people fail HEADING 2.

Jon: Now have HEADING 2 and 2T.

Jon: Could make HEADING 2 a recommendation.

Jon: Will make both HEADING 2 and HEADING 2T recommendations.

Ann: Next meeting will be Dec. 19th, and after that, January 9th.