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.

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

ARIA WG recharter #282

Open
1 task done
michael-n-cooper opened this issue Aug 6, 2021 · 17 comments
Open
1 task done

ARIA WG recharter #282

michael-n-cooper opened this issue Aug 6, 2021 · 17 comments

Comments

@michael-n-cooper
Copy link
Member

@michael-n-cooper michael-n-cooper commented Aug 6, 2021

New charter proposal, reviewers please take note.

Charter Review

Charter:

What kind of charter is this? Check the relevant box / remove irrelevant branches.

  • New
  • New WG
  • New IG
  • If this is a new WG or IG charter request, link to Advance Notice, and any issue discussion:
  • Existing
  • Existing WG recharter
  • Existing IG recharter
  • If this is a charter extension or revision, link a diff from previous charter, and any issue discussion:

Horizontal Reviews: apply the Github label "Horizontal review requested" to request reviews for accessibility (a11y), internationalization (i18n), privacy, and security. Also add a "card" for this issue to the Strategy Funnel.

Communities suggested for outreach:

Known or potential areas of concern:

Where would charter proponents like to see issues raised? (this strategy funnel issue, a different github repo, email, ...)

Anything else we should think about as we review?

@himorin
Copy link

@himorin himorin commented Aug 24, 2021

No comment/request from i18n.

@plehegar
Copy link
Member

@plehegar plehegar commented Aug 26, 2021

Would https://www.w3.org/TR/using-aria/ fit into this charter since we'd like to close the Web Platform WG finally? cc @stevefaulkner @DavidMacDonald

@samuelweiler
Copy link
Member

@samuelweiler samuelweiler commented Sep 1, 2021

As a naive reader, ARIA's scope and work products are not clear, and I would love to see some rewrites in the introduction and/or scope. Here are some questions that may help:

"...to address needs reported by authors...": authors of what? Who are we serving here, and who's input are we listening to?

"...to achieve parity with native host languages...": what is a native host language? Is there a way to say this in plainer language? (This term is used at least three times.)

"For each ARIA specification developed by this Working Group, create a corresponding Accessibility API Mappings specification ..." It seems odd that all specifications developed by the "ARIA WG" are somehow not "ARIA specifications". Is the term ARIA overloaded here? Again, is there a way to unpack this for the naive reader? (e.g. The list of deliverables doesn't seem pairwise matched, as I might expect from the current Scope - I see "Core Accessibility API mappings" with no "Core Accessibility API" "ARIA specification", "Digital Publishing Accessibility API Mappings" with no "Digital Publishing Accessibility API" "ARIA specification".)

How can you write this for a technically sophisticated reader who knows nothing about a11y?

Nit: the Digital Publishing Accessibility API Mappings link is wrong.

I see that most, if not all, if the current ARIA specs do not include the requisite Security and Privacy analyses and write ups. I'm glad to see that the proposed charter requires those.

@plehegar
Copy link
Member

@plehegar plehegar commented Sep 10, 2021

Should SVG-AAM be added to this charter?

@michael-n-cooper
Copy link
Member Author

@michael-n-cooper michael-n-cooper commented Oct 5, 2021

@plehegar

Would https://www.w3.org/TR/using-aria/ fit into this charter since we'd like to close the Web Platform WG finally?

Using ARIA, despite its name, was not produced by the ARIA WG. That document is one source of guidance for ARIA in HTML, also the name of a TR doc, also not produced by the ARIA WG. The HTML-specific aspects of this guidance is beyond the scope of the ARIA WG, and the rest of the guidance is covered in the WAI-ARIA Authoring Practices which receives a lot of investment in the ARIA WG. I suggest, if the Web Platform WG does not want to maintain that document, it be retired, possibly with a reference to the Practices.

@michael-n-cooper
Copy link
Member Author

@michael-n-cooper michael-n-cooper commented Oct 5, 2021

@samuelweiler

As a naive reader, ARIA's scope and work products are not clear, and I would love to see some rewrites in the introduction and/or scope. Here are some questions that may help:

"...to address needs reported by authors...": authors of what? Who are we serving here, and who's input are we listening to?

I added "of accessible content" to that sentence. It is people making Web content using emerging design patterns that they are not able to make fully accessible, who identify ARIA features that may be needed.

"...to achieve parity with native host languages...": what is a native host language? Is there a way to say this in plainer language? (This term is used at least three times.)

I added after the first instance (excluding mission at the top) "(markup languages such as HTML or SVG that can use ARIA attributes to provide additional accessibility information)".

"For each ARIA specification developed by this Working Group, create a corresponding Accessibility API Mappings specification ..." It seems odd that all specifications developed by the "ARIA WG" are somehow not "ARIA specifications". Is the term ARIA overloaded here?

I don't think all specifications developed by a group need to be named for the group. Accessible Rich Internet Applications Working Group is the most clear description of what the group does.

Again, is there a way to unpack this for the naive reader? (e.g. The list of deliverables doesn't seem pairwise matched, as I might expect from the current Scope - I see "Core Accessibility API mappings" with no "Core Accessibility API" "ARIA specification", "Digital Publishing Accessibility API Mappings" with no "Digital Publishing Accessibility API" "ARIA specification".)

The answer to this is not concise enough for a charter, and I think is not needed detail. Because we develop on varying timelines, not all specifications are included in this charter. However, I did add DPub ARIA, accompanying DPub-AAM, since the group has resumed work on that recently.

How can you write this for a technically sophisticated reader who knows nothing about a11y?

In the structure of a charter, I don't think we can.

Nit: the Digital Publishing Accessibility API Mappings link is wrong.

Fixed.

@marcoscaceres
Copy link
Member

@marcoscaceres marcoscaceres commented Oct 6, 2021

ReSpec flagged that the Aria specs were using the old W3C Document license. It would be great if we could move Aria WG to use more permissive W3C-software-doc license instead.

@plehegar
Copy link
Member

@plehegar plehegar commented Oct 7, 2021

@michael-n-cooper

re "Using ARIA", ok.

Can we switch the Group to the more permissive licence?

@michael-n-cooper
Copy link
Member Author

@michael-n-cooper michael-n-cooper commented Oct 7, 2021

ARIA participants are checking with their organizations to see if they can support a license change.

Note that this is an instance of the tail wagging the dog, i.e., a change being proposed for tool convenience rather than what is correct for the spec. Tools should meet the needs of specs, and the W3C Document License is still valid (and recommended for its purpose) as far as I know, so tools should support it.

@cyns
Copy link

@cyns cyns commented Oct 7, 2021

Google prefers the Software and Document license

@marcoscaceres
Copy link
Member

@marcoscaceres marcoscaceres commented Oct 7, 2021

No, that’s not true at all @michael-n-cooper. It’s because it’s a better license for everyone and it makes a huge difference to implementers (e.g., being able to copy/paste spec text into C++ code).

@cookiecrook
Copy link

@cookiecrook cookiecrook commented Oct 7, 2021

Apple also prefers the Software and Document license.

@tantek
Copy link
Member

@tantek tantek commented Oct 8, 2021

Mozilla also prefers the W3C Software and Document license for working group charters, and we have been consistently requesting this license whenever charters are updated.

(Originally published at: https://tantek.com/2021/280/t1/)

@jnurthen
Copy link
Member

@jnurthen jnurthen commented Oct 14, 2021

Sent CFC to group to change license in charter https://lists.w3.org/Archives/Public/public-aria-admin/2021Oct/0001.html

@michael-n-cooper
Copy link
Member Author

@michael-n-cooper michael-n-cooper commented Oct 19, 2021

The ARIA WG agreed to the license change and the charter is updated.

@marcoscaceres
Copy link
Member

@marcoscaceres marcoscaceres commented Oct 19, 2021

Excellent! Thanks for the update and making that happen 🙏

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