RE: [wbs] response to 'WAI Curricula Starfish review for Modules 4, 5, and 6 of curriculum Developing Accessible Content'

Hey David,

Thanks for filling in the survey. Comments and proposals below.

You can see a preview of my proposed changes at
https://deploy-preview-241--wai-curricula.netlify.app/curricula/developing-accessible-content/

There you can navigate the different modules and topics. This is a life draft which I will be updating based on Task Force feedback.

The editor's draft (now frozen for people to review), continues to be at
https://wai-curricula.netlify.com/curricula/developing-accessible-content/

> > ---------------------------------
> > Module 4: Tabular Information
> >
> > ----
> > Please focus on Module 4: Tabular Information
> >  * Are all points covered - is anything missing?
> >  * Is there anything in there that should not be in there?
> >  * Do you agree with the overall topic structure?
> > Please focus on Learning outcomes for module 4 and contrast them with
> > the learning outcomes for each of the topics in the module. Do you
> > think they fit well together?
> > You can comment below or leave a GitHub Issue about Tabular
> > Information
> >
> Comments:
> Suggest editing the fourth learning outcome to say: "explain strategies that people with disabilities use to navigate and understand
> information presented in tables"

Done.

> I expected to see coverage of sortable table functionality in the complex tables section, but perhaps this will be treated in the widgets
> module? I think that sortable tables are so common these days that I would treat them in a module on tabular information rather than in
> widgets.

Sortable tables have now been added to topic "Complex tables". There is mention in the introductory paragraph, there are learning outcomes, a teaching idea and an idea to assess knowledge. Is that the kind of content you expected? Any other suggestion to refine these additions?

> > ---------------------------------
> > Module 5: Forms and Input Elements
> >
> > ----
> > Please focus on Module 5: Forms and Input Elements
> >  * Are all points covered - is anything missing?
> >  * Is there anything in there that should not be in there?
> >  * Do you agree with the overall topic structure?
> > Please focus on Learning outcomes for module 5 and contrast them with
> > the learning outcomes for each of the topics in the module. Do you
> > think they fit well together?
> > You can comment below or leave a GitHub Issue about Forms and Input
> > Elements
> >
> Comments:
> Missing: coverage of appropriate use of placeholder attribute, including warning against relying on placeholder for visible label 

I have added references to placeholder in the topic "Form Instructions", learning outcomes, bullet 3,  as I think this is the most appropriate place where it fits. I have also added in teaching ideas of that topic, second bullet, a warning that the value of the placeholder disappears after the user enters a value.

I also have added reference *not* to rely on placeholder for labels in the topic "Form labels" teaching ideas, first bullet.

> I was surprised to see time limits addressed in this module, as time limits need not specifically apply to pages with forms. But maybe it's the best
> place for this sub-topic.

I thought so. In the current teaching sequence that we are building, it seemed like the first (and most apparent) place where it fits for me. I definitely see other scenarios such as dynamic updates or time-based content that is shown or hidden, and we could add references to time limits also for those scenarios. Do you think it should go first in the sequence? Later on?

> Topic: Form Labels, Learning Outcomes—missing code markup for "for" in the first bullet point

This has now been added.

> > ---------------------------------
> > Module 6: Widgets
> >
> > ----
> > Please focus on Module 6: Widgets
> >  * Are all points covered - is anything missing?
> >  * Is there anything in there that should not be in there?
> >  * Do you agree with the overall topic structure?
> > Please focus on Learning outcomes for module 6 and contrast them with
> > the learning outcomes for each of the topics in the module. Do you
> > think they fit well together?
> > You can comment below or leave a GitHub Issue about Widgets
> >
> Comments:
> I'm having difficulty reconciling the module title "Widgets" with the topic list. It seems to me to tend more to the theoretical than the
> practical, by looking at different widget types (e.g. for managing display of content, for adding interactivity to static content). That said, I
> do agree with the need to cover are some fundamental underlying topics to extending native HTML to create interactive components
> (specifically what ARIA brings to the table in terms of semantics and state/value management, keyboard management, and notifications).
> I'm not immediately sure how to resolve this, unless it's intended to include a follow-up module that looks at how to implement the theory
> in practice?

I do agree that this module looks very theoretical, in contrast with the other ones. I would like to fix that in this very module. I am not sure what you are missing. Is it more examples on how to code custom components? Maybe changing the title to something like "Custom widgets" or "Custom components" to convey the idea that this is something the developer needs to create themselves rather than just implement some given semantics? Are you missing additional topics on specific types of custom widgets and detailed instructions on how to code them?

> > ---------------------------------
> > Module 3: Images and Graphics
> >
> > ----
> > Please focus on Module 3: Images and Graphics
> >  * Are all points covered - is anything missing?
> >  * Is there anything in there that should not be in there?
> >  * Do you agree with the overall topic structure?
> > Please focus on Learning outcomes for module 3 and contrast them with
> > the learning outcomes for each of the topics in the module. Do you
> > think they fit well together?
> > You can comment below or leave a GitHub Issue about Images and
> > Graphics
> >
> Comments:
> 
> 
> >
> >
> > ---------------------------------
> > Module 2: Navigation and Menus
> >
> > ----
> > Please focus on Module 2: Navigational Menus.
> >  * Are all points covered - is anything missing?
> >  * Is there anything in there that should not be in there?
> >  * Do you agree with the overall topic structure?
> > Please focus on Learning outcomes for module 2 and contrast them with
> > the learning outcomes for each of the topics in the module. Do you
> > think they fit well together?
> > You can comment below or leave a GitHub Issue about Navigational Menus
> >
> Comments:
> 
> 
> >
> >
> > ---------------------------------
> > Module 1: Page Structure
> >
> > ----
> > Please focus on Module 1: Page Structure
> >  * Are all points covered - is anything missing?
> >  * Is there anything in there that should not be in there?
> >  * Do you agree with the overall topic structure?
> > Please focus on Learning outcomes for module 1 and contrast them with
> > the learning outcomes for each of the topics in the module. Do you
> > think they fit well together?
> > You can comment below or leave a GitHub Issue about Page Structure
> >
> Comments:
> 
> 
> >
> >
> > ---------------------------------
> > Additional comments
> >
> > ----
> > Use the space below to include any additional observations or concerns
> > you would like to see addressed at this stage.
> >
> Additional Comments:
> Generally, I like the direction the three module descriptions I reviewed are headed—good work!
> 
> I think the phrase "Optional ideas to teach the learning outcomes" used in the Teaching Ideas for Topic section of each module description
> could be rephrased to emphasise that it is learners who should achieve the outcomes and teachers help them achieve these outcomes
> through instructing and providing learning activities:
> 
> Suggested reword: "Optional teaching ideas to help learners achieve the defined learning outcomes"
> 
> I agree with a previous survey comment that some verbs used in the Learning Outcomes do not match standard taxonomies  (e.g. Bloom's).
> 
> >
> > These answers were last modified on 21 August 2020 at 17:07:00 U.T.C.
> > by David Sloan
> >
> Answers to this questionnaire can be set and changed at https://www.w3.org/2002/09/wbs/35532/developers-curricula-modules-456/
> until 2020-08-26.
> 
>  Regards,
> 
>  The Automatic WBS Mailer


--

Daniel Montalvo

Accessibility Education and Training Specialist
W3C/WAI

Received on Monday, 24 August 2020 12:57:03 UTC