w3c / wai-aria-practices

WAI Website Resource for aria-practices guidelines
https://aria-practices.netlify.app/aria/apg/
15 stars 14 forks source link

Include updated landmark example pages and WAI site-wide search #270

Open howard-e opened 9 months ago

howard-e commented 9 months ago

Once https://github.com/w3c/wai-website/pull/362 is approved and deployed, it will exclude the following landmark example pages from the WAI’s site search:

The reason why these specific pages have to be excluded is noted in: https://github.com/w3c/wai-website/issues/357

When searching for a phrase present in the ARIA Practices Guide documentation, I get many entries that do not contain a link to the search result. The reason is that the search uses front matter information to put these results together. The APG uses HTML documents that do not follow the template.

@mcking65 noted there are plans to fix these pages which means they will eventually match the format of the other APG related pages (which are already searchable). When that is done, we will be able to re-include the exclusions in the WAI site search. See https://github.com/w3c/wai-website/pull/358#issuecomment-1747476516.

Note that https://www.w3.org/WAI/ARIA/apg/practices/landmark-regions/ will still be searchable which also links to these pages.