w3c / wai-media-guide

11 stars 41 forks source link

typo in summary on Planning page #110

Closed terrill closed 5 years ago

terrill commented 5 years ago

The first bullet in the Summary o the Planning Audio and Video Media page says this:

figure out what your specific audio or video needs (captions, description, a transcript, etc.)

Possible solutions:

  1. Add the word "are" after the word "needs"
  2. Remove the word "what"
  3. Express differently, maybe "Determine your specific audio or video needs"
shawna-slh commented 5 years ago

Hum, that wording works for me as a shorter way of saying:

figure out what THINGS your specific audio or video needs (captions, description, a transcript, etc.)

Yet you are at least the second person to note it, so clearly it doesn't work for others. :-)

Thank you for the including possible solutions.

Would this wording work:

figure out what your specific audio or video needs to be accessible (captions, description, a transcript, etc.)

@vmmiller what do you think?

vmmiller commented 5 years ago

Yes, that works, Shawn!

shawna-slh commented 5 years ago

Change made. Closing this issue. (Re-open if needed.)

terrill commented 5 years ago

My reaction to the original language - I now realize - was because I was perceiving "needs" to be a noun, whereas you're intending it to be perceived as a verb. If it's a noun, the new version still has the same problem - it seems to be missing a verb.

shawna-slh commented 5 years ago

figure out what you need to provide for your specific audio or video (captions, description, a transcript, etc.)

seems overly wordy -- but maybe better, clearer... ?

bakkenb commented 5 years ago

Still not clear. How about...

figure out what your specific audio or video needs in order to be accessible (captions, description, a transcript, etc.)

terrill commented 5 years ago

I like the addition of "in order to be accessible" - somehow that helps me to recognize "needs" as a verb. Is "specific" necessary? It's a little shorter without it.

figure out what your audio or video needs in order to be accessible (captions, descriptions, a transcript, etc.)

shawna-slh commented 5 years ago

The editor in me reacts to "in order" as unnecessarily wordy. :-( And even "to be accessible" is unnecessary given the context.

Based on earlier exchange with Vicki, we edited a parallel version of that sentence in the Intro page to

To figure out which accessibility aspects your specific audio or video needs...

So I'll go with that on the Planning page, too.

bakkenb commented 5 years ago

+1 to that.