w3c / aria-common

Shared files for the ARIA repositories
Other
8 stars 15 forks source link

out of date links for accessibility APIs #34

Closed scottaohara closed 4 years ago

scottaohara commented 5 years ago

I found that the macOS Accessibility Protocol link goes to a page stating:

A legacy, informal protocol that is not recommended for active use.

Additionally in the Important Terms section the link Linux/Unix Accessibility Toolkit returns a 403.

@cookiecrook and @joanmarie can you verify where the preferred urls these links should point to now? I can make the PR / will also update HTML AAM accordingly.

Thanks

joanmarie commented 5 years ago

@scottaohara Thanks for catching this. The place to fix it, at least for Core-AAM, is in https://github.com/w3c/aria-common/blob/master/terms.html. Those periodically get pulled into our specs.

BUT: The ATK "unstable" link 403ing is unexpected. I think we want to continue point to the unstable docs IF we can. Therefore, I filed this issue: https://gitlab.gnome.org/Infrastructure/Infrastructure/issues/179

If it turns out we cannot continue to point to that, the correct link would be s/unstable/stable/

Thanks!!

cookiecrook commented 4 years ago

This is probably the best link for the Mac reference. https://developer.apple.com/library/archive/documentation/Accessibility/Conceptual/AccessibilityMacOSX/index.html

Optionally, you could leave the link text the same and reference: https://developer.apple.com/documentation/appkit/nsaccessibility

scottaohara commented 4 years ago

thank you