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

Rename "interactiveDescription" to "altInputAndDescription" #1302

Closed
zepumph opened this issue Oct 21, 2021 · 3 comments
Closed

Rename "interactiveDescription" to "altInputAndDescription" #1302

zepumph opened this issue Oct 21, 2021 · 3 comments
Assignees

Comments

@zepumph
Copy link
Member

zepumph commented Oct 21, 2021

From a design meeting today where we were prioritizing https://github.com/phetsims/phet-io/issues/1611, we recommended to rename the term "Interactive Description." This no longer has anything to do with alternative input. It was also argued that it is confusing that alt input is a subset of Interactive Description, as opposed to just a precursor. Especially using the website filter page as an example, alt input is separate from the Interactive Description feature. It is still an implementation detail that alt input and interactive description both run off the same scenery flag, and one can't be turned on without the other. Furthermore there is no codified way (besides in the published sim database) to determine if a sim supports alt input, interactive description, or both. It wasn't totally clear on this point, but I believe we were saying that there would be no more name for the "Umbrella term," and it would just be recognized that Interactive Description can only come after alternative input is complete.

Steps that will need to occur to accomplish this:

The next step is to touch base with the a11y team to see how much this aligns with their understanding of things.

@zepumph zepumph self-assigned this Oct 21, 2021
@zepumph
Copy link
Member Author

zepumph commented Oct 27, 2021

Some person notes from my scrapbook



interactiveDescription: "pdom" descriptionUTteranceQueue
altInputAndInteractiveDescription: "pdom" descriptionUTteranceQueue
altInputAndDescription: "pdom" descriptionUTteranceQueue

supportsAltInputAndInteractiveDescription=true
supportsAltInputAndDescription=true

perennial/data/alt-input-and-interactive-description
perennial/data/alt-input-and-description


(state/response) description
alt input

Interaction Description


enablePDOM:
	stateDescription
	alt input

enableResponse:

@zepumph zepumph assigned emily-phet and unassigned zepumph Nov 3, 2021
@emily-phet
Copy link

@kathy-phet and I spoke about this on 11/5/21. I expressed that after discussion with Taliesin, Jesse, and Michael, our recommendation was to not rename. There are a number of reasons for this, but a few discussed include the following (this is not a complete list, please do not base any further decisions based solely on these few examples):

  • Instrumenting a simulation with alternative input explicitly allows for navigation with a screen reader, which will result in the screen reader reading out information to the user. Our choice to not always design descriptive information that is provided to the screen reader to make this a usable experience to someone utilizing a screen reader is purely a "convenience", and is an artifact of our design process, allocation of resources, etc. It is not intrinsic to the feature itself, which was always intended to include both navigability using a keyboard, screen reader, and other forms of alternative input, along with at least some designed descriptive content (recall "simple description").
  • Another relevant issue is that the term "description" is not exclusive to the Interactive Description feature. Description in the general sense of the word is used in Voicing, and potentially other features.

My recommendation to Kathy was to follow up on this issue in a facilitated developer meeting.

@zepumph
Copy link
Member Author

zepumph commented Oct 14, 2022

We are not going to rename here. This issue is old. Feel free to reopen! Closing

@zepumph zepumph closed this as completed Oct 14, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

3 participants