aria-practices icon indicating copy to clipboard operation
aria-practices copied to clipboard

Add the date picker dialog example to design pattern page

Open a11ydoer opened this issue 2 years ago • 6 comments

Feedback from Terrill Thompson at Educause IT accessibility Community. It will be also plus if we can add "search" section for the design pattern. (Adding "search" is in the next project milestone.)

"I'm pretty sure APG v 1.1 included a calendar widget as an example. I'm not sure if that was still present in v 1.2, or if it's still present in the new version. If I search the home page for "calendar" I get no results, but maybe it's out there somewhere as an example of a particular design pattern - I'm just not sure which one. "

a11ydoer avatar May 20 '22 15:05 a11ydoer

The date picker widget still has at least 24 open issues: https://github.com/w3c/aria-practices/issues?q=is%3Aissue+is%3Aopen+date+picker

You can also see a to-do list in the project dedicated to it: https://github.com/w3c/aria-practices/projects/27

As your links show, many of the patterns are not linked on the page but are still available via URL hacking. I cannot speak to why that is the case, but I don't think the pattern is in good enough shape to warrant linking.

Regardless, I suggest against linking it since there is a risk someone will assume it is production ready.

aardrian avatar May 20 '22 17:05 aardrian

Feedback from Terrill Thompson at Educause IT accessibility Community. It will be also plus if we can add "search" section for the design pattern. (Adding "search" is in the next project milestone.)

"I'm pretty sure APG v 1.1 included a calendar widget as an example. I'm not sure if that was still present in v 1.2, or if it's still present in the new version. If I search the home page for "calendar" I get no results, but maybe it's out there somewhere as an example of a particular design pattern - I'm just not sure which one. "

This issue may be simply improving the info architecture or description of patterns so that calendar widget can be found easily, not only from Example index page.

a11ydoer avatar May 20 '22 19:05 a11ydoer

@aardrian

The date picker widget still has at least 24 open issues: https://github.com/w3c/aria-practices/issues?q=is%3Aissue+is%3Aopen+date+picker

You can also see a to-do list in the project dedicated to it: https://github.com/w3c/aria-practices/projects/27

As your links show, many of the patterns are not linked on the page but are still available via URL hacking. I cannot speak to why that is the case, but I don't think the pattern is in good enough shape to warrant linking.

Regardless, I suggest against linking it since there is a risk someone will assume it is production ready.

Thanks for looking into Date Picker pattern open issue and the project board. However, your judgement is soley on the number of Github issues. I don't see any critical bugs for this example unless I missed it. Also in the project board, we add topics to enhance the pattern example or feedback. The project board is not the indication of this pattern is "not good enough"

It would be more productive/constructive feedback if you can exactly point out "why you don't think the pattern is in good enough shape to warrant linking." by filing a github issue like others. APG working group is happy to work on those issues.

Furthermore, there is the misunderstanding that APG aims to provide for "production ready widget". I hope you can find time to read "About APG"

@mcking65

a11ydoer avatar May 20 '22 19:05 a11ydoer

Thanks for looking into Date Picker pattern open issue and the project board. However, your judgement is soley on the number of Github issues. I don't see any critical bugs for this example unless I missed it.

It is not my judgment. It was my assumption the date picker is not linked is because it has that many open issues. It was my mistake for assuming that as opposed to some other decision process. I apologize for that. I also did not look to see which of the open issues were marked critical.

Furthermore, there is the misunderstanding that APG aims to provide for "production ready widget". I hope you can find time to read "About APG"

On that point I have been raising my concerns for years (at least since 2017).

aardrian avatar May 20 '22 21:05 aardrian

@aardrian Thanks for the response.

Menu navigation example is where we are still asked for the clarification. Even we had one feedback about the menu example pattern today. I did not have the chance to re-read your Github issue Clarify Purpose of Menu Navigation #353 yet. But I will do any follow up if needed.

My point about the "About APG" page is that we don't aim to provide a "production ready widget". (Who would use simple vanilla javascript code to create the widget while there are lots of great JS library widgets? :-) ) In other words, ARIA APG WG tries to help people to understand how to use ARIA via various design pattern examples.

a11ydoer avatar May 20 '22 21:05 a11ydoer

@aardrian I might also misunderstand your "production ready" concept. (I was busy with wrapping up the work for the weekend.) You might mean "production ready" for new APG site.

As one useful info, APG will be ever green document with this new APG site, not necessarily "production ready" concept for examples. (We are working on provding the updated date info and semantic indication for any updated example.)

a11ydoer avatar May 20 '22 21:05 a11ydoer