phetsims / phet-info

Collection of information shared by PhET team members for the purpose of using github effectively and for other process-related topics.
MIT License
59 stars 27 forks source link

Document the design process for adding alternative input to a simulation #223

Open jessegreenberg opened 1 month ago

jessegreenberg commented 1 month ago

It would be helpful to create a high level checklist that describes how to add alt input to a simulation, and what to think about.

terracoda commented 1 month ago

I spoke with designers, we talked about several things, but we did not determine a high-level checklist. I'll have to draft one and get feedback.

terracoda commented 1 month ago

Not sure this is what we want, but here's a start:

terracoda commented 1 month ago

Actually there are 3 Design Tasks in the Alternative Input design doc template. Those seem to be a good checklist, so just adding the first one about starting early.

  1. Start thinking about Alternative Input as early as possible in the design process.
  2. Organize Interactions within Play Area and Control Area.
  3. Create a Keyboard Shortcuts Dialog.
  4. Accessible Text for Keyboard Shortcuts Dialog (not required for Alternative Input alone; required for Interactive Description and Voicing features).
terracoda commented 1 month ago

Updated Checklist:

  1. Start thinking about Alternative Input as early as possible in the design process, and include the team member with Alternative Input design expertise on a regular basis as interactions are being considered. This can influence interaction choices.
  2. Organize interactions in the order of pedagogical importance within the Play Area and Control Area. This can influence layout decisions.
  3. Nearing interviews, create a Keyboard Shortcuts Dialog. Common code interactions have generic associated keyboard instructions. Adjust the generic headings and verbs if pedagogically necessary. For example, you might want to use "move" instead of "adjust", for a slider-type interaction. Keep instructions simple with one action per key press.
  4. Accessible text for Keyboard Shortcuts Dialog is needed in addition to the visual display when features include Interactive Description or Voicing. There's a standard way to write the accessible text.
terracoda commented 1 month ago

Amanda suggested the following for the Inclusive Features/Alternative Input section of the Sim Checklist:

We'll discuss the adjustments to the Design section of the same check list at the next design meeting.