vuejs / docs

📄 Documentation for Vue 3
https://vuejs.org
Other
2.94k stars 4.44k forks source link

Update Accessibility Documentation on content structure (landmarks) #2440

Closed dnikub closed 1 month ago

dnikub commented 1 year ago

Hello,

I noticed that inside your accessibility documentation in the section Content Structure, you have a tip for landmarks that's not up-to-date. The quote I am referring to is this:

Tip: It is recommended to use landmark HTML elements with redundant landmark role attributes in order to maximize compatibility with legacy browsers that don't support HTML5 semantic elements.

I believe this tip can be removed from the Vue 3 docs due to multiple reasons:

I recommend replacing the current tip with the just-named information. The table of examples for landmark roles you give within your docs implies using the redundant ARIA roles is what one should do.

Thanks!

ranjbarreza commented 1 month ago

Hi @dnikub I made this PR: https://github.com/vuejs/docs/pull/2996 (@bencodezen) Could you take a look please?