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

Make note about new location of WAI-ARIA patterns more prominent in Shortened TR Docs #2332

Closed
hlee-cb opened this issue May 19, 2022 · 4 comments
Assignees
Labels
enhancement Any addition or improvement that doesn't fix a code bug or prose inaccuracy Feedback Issue raised by or for collecting input from people outside APG task force Infrastructure Related to maintaining task force and repo operations, processes, systems, documentation

Comments

@hlee-cb
Copy link

hlee-cb commented May 19, 2022

This is a very small issue, but it seems as of this morning that the old WAI-ARIA Patterns document was emptied of content old document, except for the abstract which points to the more up-to-date version.

I had the old version bookmarked and nearly had a heart attack this morning when it appeared to be completely empty. As the old document is still the first result returning from a search for "WAI ARIA authoring practices", I think the note pointing to the new resources should be bolded or made more prominent in some way.

@joe-watkins
Copy link

Is there a plan for URL redirects for 1.2 examples that have been around for a while?
https://www.w3.org/TR/wai-aria-practices-1.2/examples/dialog-modal/dialog.html

How does one access the old 1.0 and 1.1 references?
https://www.w3.org/TR/wai-aria-practices-1.1/examples/combobox/aria1.0pattern/combobox-autocomplete-both.html
https://www.w3.org/TR/wai-aria-practices-1.1/examples/combobox/aria1.1pattern/listbox-combo.html

@mcking65
Copy link
Contributor

@mbgower mentioned that we could also change the 1.2 and 1.1 docs at the top where they point to latest. Currently, "Latest" and "Latest Editor's Draft" both point to out-of-date locations, putting people into a loop if they don't read further down in the doc.

@mcking65 mcking65 changed the title Make note about new location of WAI-ARIA patterns more prominent Make note about new location of WAI-ARIA patterns more prominent in Shortened TR Docs May 19, 2022
@mcking65 mcking65 added enhancement Any addition or improvement that doesn't fix a code bug or prose inaccuracy Feedback Issue raised by or for collecting input from people outside APG task force Infrastructure Related to maintaining task force and repo operations, processes, systems, documentation labels May 19, 2022
@mcking65 mcking65 added this to the Q2/2022 Updates milestone May 19, 2022
@thibaudcolas
Copy link

Came here to report the same thing – this is particularly confusing because (as far as I can tell), the document’s title is the same as before, and it’s still the #1 search result for "aria authoring practices" (presumably because no redirects or canonical rel links have been set up, see #2335).

@mcking65
Copy link
Contributor

mcking65 commented Feb 1, 2023

This issue was addressed by the fixes to #2335:

  • The shortened TR docs now redirect to the new APG site
  • The dated versions have a modal dialog popup telling the user the doc is out of date and referencing the new APG site

@mcking65 mcking65 closed this as completed Feb 1, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement Any addition or improvement that doesn't fix a code bug or prose inaccuracy Feedback Issue raised by or for collecting input from people outside APG task force Infrastructure Related to maintaining task force and repo operations, processes, systems, documentation
Projects
None yet
Development

No branches or pull requests

5 participants