w3c / a11y-discov-vocab

Repository for the maintenance of the schema.org accessibility property values for discoverability.
https://www.w3.org/community/a11y-discov-vocab/
Other
15 stars 8 forks source link

Wrong API in 2.2.9 #45

Closed JAWS-test closed 2 years ago

JAWS-test commented 2 years ago

2.2.9 MacOSXAccessibility: Indicates the resource is compatible with the iAccessible2 API for Windows.

Should be: MacOS

mattgarrish commented 2 years ago

Thanks, yes, that definitely looks like a copy/paste error when the definitions were added. The OS and API are both from the iAccessible2 definition.

The original IMS definition is:

Indicates the application provides support for the Mac OSX Accessibility Protocol

The IMS definitions also link to the API definitions. That seems like it would be useful to add.

mattgarrish commented 2 years ago

@madeleinerothberg @clapierre This issue raises a couple of other questions for me in trying to fix.

First, it's no long "MacOSX", so should we deprecate this property and create a new one called "macOSAccessibility"?

Second, do either of you know where the iOS Accessibility API is documented? I've only found a few references to it on the web, but no official documentation.

clapierre commented 2 years ago

The OS on Mac's is considered MacOS, not sure where MacOSX came from, as for the API documentation I haven't a clue Sorry

madeleinerothberg commented 2 years ago

I’ll see if I can find anything. It must be there somewhere….

-Madeleine

From: Charles LaPierre @.> Reply-To: w3c/a11y-discov-vocab @.> Date: Thursday, March 3, 2022 at 9:01 AM To: w3c/a11y-discov-vocab @.> Cc: Madeleine Rothberg @.>, Mention @.***> Subject: Re: [w3c/a11y-discov-vocab] Wrong API in 2.2.9 (Issue #45)

The OS on Mac's is considered MacOS, not sure where MacOSX came from, as for the API documentation I haven't a clue Sorry

— Reply to this email directly, view it on GitHubhttps://github.com/w3c/a11y-discov-vocab/issues/45#issuecomment-1058070162, or unsubscribehttps://github.com/notifications/unsubscribe-auth/AC2TKFOWRQXUYXAWCM5H77LU6DA3DANCNFSM5PZOKGOA. Triage notifications on the go with GitHub Mobile for iOShttps://apps.apple.com/app/apple-store/id1477376905?ct=notification-email&mt=8&pt=524675 or Androidhttps://play.google.com/store/apps/details?id=com.github.android&referrer=utm_campaign%3Dnotification-email%26utm_medium%3Demail%26utm_source%3Dgithub. You are receiving this because you were mentioned.Message ID: @.***>

mattgarrish commented 2 years ago

not sure where MacOSX came from

That was the old name for the OS:

macOS (originally named "Mac OS X" until 2012 and then "OS X" until 2016)[10] is the current Mac operating system that officially succeeded the classic Mac OS in 2001.

https://en.wikipedia.org/wiki/Macintosh_operating_systems#Mac_OS_X_/_OS_X_/_macOS

It still made sense when we created the vocabulary, even if it was "OS X" then, but not so much anymore.

mattgarrish commented 2 years ago

It must be there somewhere….

Best I've found is that it stands for their UIAccessibility API: https://developer.apple.com/documentation/objectivec/nsobject/uiaccessibility

Does that seem right?

madeleinerothberg commented 2 years ago

It looks like UIKit is for iOS and tvOS: https://developer.apple.com/documentation/uikit/accessibility_for_uikit

And AppKit is for MacOS: https://developer.apple.com/documentation/appkit/accessibility_for_appkit

-Madeleine

From: Matt Garrish @.> Reply-To: w3c/a11y-discov-vocab @.> Date: Thursday, March 3, 2022 at 10:43 AM To: w3c/a11y-discov-vocab @.> Cc: Madeleine Rothberg @.>, Mention @.***> Subject: Re: [w3c/a11y-discov-vocab] Wrong API in 2.2.9 (Issue #45)

It must be there somewhere….

Best I've found is that it stands for their UIAccessibility API: https://developer.apple.com/documentation/objectivec/nsobject/uiaccessibility

Does that seem right?

— Reply to this email directly, view it on GitHubhttps://github.com/w3c/a11y-discov-vocab/issues/45#issuecomment-1058173282, or unsubscribehttps://github.com/notifications/unsubscribe-auth/AC2TKFK4SLMJJAXYG6ZQQMDU6DM2VANCNFSM5PZOKGOA. Triage notifications on the go with GitHub Mobile for iOShttps://apps.apple.com/app/apple-store/id1477376905?ct=notification-email&mt=8&pt=524675 or Androidhttps://play.google.com/store/apps/details?id=com.github.android&referrer=utm_campaign%3Dnotification-email%26utm_medium%3Demail%26utm_source%3Dgithub. You are receiving this because you were mentioned.Message ID: @.***>

mattgarrish commented 2 years ago

It looks like UIKit is for iOS and tvOS:

Ya, that's where I found the link to the UIAccessibility API. Should we maybe deprecate "iOSAccessibility" and create "UIAccessibility" given that it's the API for both iOS and tvOS apps?

And AppKit is for MacOS:

Right, and the API for AppKit appears to be NSAccessibility. Perhaps this is what we should deprecate MacOSXAccessibility for?