Accessibility validation and status

[ecureuill]

Index

1. Accessibility Validation
   1. Accessibility Validation Filter
   2. Accessibility Validation Progress
   3. Accessibility Configuration
   4. Content Area
2. Report
   1. Full accessible course
   2. Without inclusion goal
   3. With inclusion goal

      1. Inclusion Goal is achieved

         Demo

         Accessibility Validation

         During course creation, teacher will be guided by system on web content accessibility, giving teacher the opportunity to add contents with accessibility resources.

• [x] Each type of content of the Program step has a set of accessibility resources.
• [x] Optionally, teacher can configure the accessibility resources. The resources status should be:
  • well configured: teacher selects an option that is accessible
  • misconfigured: teacher selects an option that is not accessible
  • not configured: teacher does not configured the accessibility resource

Accessibility Validation Filter

This tool has the purpose to help teacher visualize accessibility problems by impairments.

• [x] Update the list of impairments in the select component as below

item	label
Cognitive	Cognitive disabilities
DiversityElderly	Elderly
Auditory	Hearing disabilities
Visual	Visual disabilities

• [x] The Accessibility Validation Filter will be loaded filtered by the selection of Audience[InclusionGoal] (#145)
• [x] At any time, teacher can change the filter of Accessibility Validation Filter in the program step. This will not change the selection of Audience[InclusionGoal]

Accessibility Validation Progress

The overall accessibility progress of a given component is presented in a Circular Progress component

• [x] component: material-UI Circular Progress with label
• [x] label: "c/t", where t is the total of accessibility resources of the component and c is the total of well configured resources of the component.
• [x] color progress: a scale of orange to green

Accessibility Configuration

List of requirements by impairments
Cognitive disabilities
Hearing disabilities
Visual disabilities
Elderly: all above

Component	Accessibility Resource	Impacted disability
Image	Short Description (if not decorative image)	visual, cognitive
Image	Long Description (only for complex image)	visual, cognitive
Video and video-only	Short Description	visual, cognitive
Video and video-only	Long Description [TRANSCRIPTION]	visual, cognitive
Video	Caption ( embedded or uploaded)	hearing
Video	Audio Description [NARRATION] ( embedded or uploaded a .vtt or alternative audio track)	visual
Video	Sign Language ( embedded or uploaded)	hearing, cognitive
Video	Seizure	cognitive
Audio	Short Description	hearing, cognitive
Audio	Long Description [TRANSCRIPTION]	hearing, cognitive
Quiz	Descriptive identification	Visual
Quiz	Extra Time	visual, cognitive, hearing
Quiz	No Time	visual, cognitive, hearing
Quiz	Warn Time	visual, cognitive, hearing
Activity	Descriptive identification	Visual
PDF	check #149
LINK	Link text	visual, cognitive

• [x] The set of accessibility resources related to the selection of Audience[InclusionGoal] will be presented with "(Required for Inclusion)" in their the visible label.
• [x] The set of accessibility resources NOT related to the selection of Audience[InclusionGoal] will be presented with in their original label.
• [x] At the top of each Accessibility Configuration form show the message: Fields presented as Required for Inclusion are accessibility resources that are necessary to achieve the course inclusion goal defined in Audience Step
• [x] Use the accessibility progress component (specified above) to present the overall accessibility status
• [x] Use feedback component (#46) to present the status of each resource.
  • well configured: presents the accessible status
  • misconfigured and not configured: presents the inaccessible status and the error message

Content Area

• [x] For each content on Content Area, system shows the accessibility progress component (specified above) to present the overall accessibility status

• [x] The overall value presented is conditional to the Accessibility Validation Filter. For example, supposing that a component has been configured 3 resources of a total of 6 resources. If all impairments is selected in Accessibility Validation Filter, the overall accessibility status will be 3/6. But if teacher filer by Visual impairments and in this hypothetical component only 2 of the 6 resources is necessary for Visual accessibility and 1 is configured, thus the overall presented will be 1/2

Report

Before publish the course, teacher could see an accessibility report for the entire course.

• [x] If teacher does not select any Inclusion Goal at Audience Step, then Publish will not be conditioned to accessibility result.
• [x] If teacher selected any Inclusion Goal at Audience Step, system must enable Publish the course only when all accessibility resources are well configured for all impairment group selected.
• [x] If teacher click on a Topic Name, system should ask if teacher wants to go to the topic ( Program Step) to fix the accessibility problems

Full accessible course

• [x] If teacher well configure all accessibility resources for all impairment groups, Report should present a message that the course is fully accessible
  

Without Inclusion Goal

• [x] Report will present the overall accessibility status for each impairment group (in percentage)
• [x] Report will present the accessibility status for each topic/unit by impairment group (in percentage)

with Inclusion Goal

• [x] Report will present the overall accessibility status of the Inclusion Goal (in percentage)
• [x] Report will present the overall number of accessibility resources well configured (Done card)
• [x] Report will present the overall number of accessibility resources not configured (TO-DO card)
• [x] Report will present the overall number of accessibility resources misconfigured (Not Accessible card)
• [x] Report will present the overall accessibility status for each impairment group of the Inclusion Goal (in percentage)
• [x] Report will present the accessibility status for each topic/unit by impairment group of the Inclusion Goal (in percentage)

Inclusion Goal is achieved

• [x] When teacher finish to well configure all accessibility resources for the Inclusion Goal, Report should suggest to Teacher to review the accessibility of other groups. Only if the inclusion goal do not include all impairment groups

• [x] Report will present the overall accessibility status of the Inclusion Goal (100% in percentage) and a message about the achievement

• [x] Report will present the overall accessibility status for each impairment group not included in Inclusion Goal (in percentage)

• [x] Report will present the accessibility status for each topic/unit by impairment group not included in Inclusion Goal (in percentage)

Wire frame

Accessibility feedback given for each content on Content Area

[github-actions[bot]]

This Feature Request was accepted and is ready for specfication.

[ecureuill]

@juantenesaca @CAndresH I finished the specification for Report step and the Accessibility validation

[ecureuill]

@CAndresH I just updated the table with the validation by components. In case of PDF (#149), each accessibility resource has a related issue that is labeled with the impacted disabilities

[CAndresH]

Hi, a question: Where on the platform should this option go? If teacher click on a Topic Name, system should ask if teacher wants to go to the topic ( Program Step) to fix the accessibility problems

[ecureuill]

Sorry @CAndresH, I didn't see your comment before.

In report, system will show accessibility progress by topi/unit in the "Topics" section. Each topic/unit should be clickable

[CAndresH]

yes Camila, I forgot that requirement, the click is in this part ?, correct? [image: image.png]

[image: image.png]

El lun., 27 jul. 2020 a las 7:49, Camilla Silva (notifications@github.com) escribió:

Sorry @CAndresH https://github.com/CAndresH, I didn't see your comment before.

In report, system will show accessibility progress by topi/unit in the "Topics" section. Each topic/unit should be clickable

— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/solex2006/SELIProject/issues/45#issuecomment-664375907, or unsubscribe https://github.com/notifications/unsubscribe-auth/AMCACKQXGLC46EBJJ4ODORDR5VZXLANCNFSM4L4HUFNA .

--

---

             Universidad del Azuay           (http://www.uazuay.edu.ec http://www.uazuay.edu.ec)

[caroltaus]

• [x] For an image to be considered decorative the user has to check it twice

here:

and here:

it would be better to delete this second check box

---

• [x] These could be shown in a 2x2 grid and the icons could be centralized to the text

---

• [x] The "You have achieved you inclusion goal" text should not appear when the user did not select any inclusion goal

---

• [x] Some accessibility configurations result in error in the percentage calculation

---

• [x] For some accessibility configurations even when ALL inclusion goals are selected only 2 (of 4) gauges are shown in the report

All inclusion goals selected: Only Hearing and Cognitive gauges are shown

---

• [x] All gauges could be the same size

[CAndresH]

Hi Caroline, could you tell me what settings you put in the course Plan to get those errors?

[caroltaus]

@CAndresH Hi! Yes, this was the configuration in Course Plan guided + toybox

[caroltaus]

• [x] Accessibility is not being validated for decorative images

when the user configures it:

it's still shown as inaccessible:

when user clicks to edit its accessibility the system shows a required text field that shouldn't exist for decorative images:

---

• [x] Nan Percentage is still appearing for some configurations, here are some: In Course Plan guided + toybox and will all Inclusion Goals selected

1 - with only one video, and its accessibilities configurations ALL accessible EXCEPT for audio description

Accessibility Report:

2- with only one audio, and completely INACCESSIBLE

Accessibility Report:

when you configure 1 out of 2 accessibility:

Accessibility Report:

[CAndresH]

Hi Caroline,

Could you now check the reports part and tell me if there are the same errors? Thank you

[caroltaus]

@CAndresH The NaN error is fixed for these situations! Thank you!

[caroltaus]

• [x] When user is on GUIDED mode there should not appear a Syllabus Accessibility Report, since the plataform is making the syllabus (already accessible)

---

• [x] When a type of accessibility is at 100% accessible the plataform should show the icons, instead of gauges

how it is:

icons that should appear instead of the gauges:

[CAndresH]

Hi Caroline, is this part "When a type of accessibility is at 100% accessible the platform should show the icons, instead of gauges", what I understood from Camila's demo is that when you do not select the audiences, the percentages should appear with the graphs and when you select the audiences (in audience step) and they are accessible 100%, then the green icons should appear,

Maybe I misunderstood, in which case I can change it, could you please confirm this with Camila?

[caroltaus]

@CAndresH Just talked to Camilla, she said it's okay to keep it as it is right now! Sorry for the confusion!

[ecureuill]

Report is presenting wrong data

• [ ] Not reporting "not configured" items (scenario 1)
• [ ] Wrongly reporting "misconfigured" items (scenario 1)
• [ ] Wrongly reporting multiple topics (scenario 2)

Scenario 1: Steps to Reproduce

1. Select Visual Disability in Audience Step
2. Add 1 topic in Design Step
3. Add 4 Images of type "Informative" with accessibility "well configured" (Image 1)
   1. Go to Report step and check that "You have achieved your Inclusion Goal" is presented with Visual Disability logo
4. Add 1 image and select to configure accessibility later
   1. Go to Report step and check that, despite there is 1 not configured accessibility, the same status of 3.i is presented (wrong)
5. Select to configure accessibility of the image lacking configuration
   1. Set the image as "Informative" and save it without informing a text alternative
   2. Go to Report step and check that, despite there is 1 misconfigured accessibility, is reported that there is 1 TO-DO and 1 NOT ACCESSIBLE (wrong)

Expected Result:

• step 4 should report 1 TO-DO and 0 NOT ACCESSIBLE
• step 5 should report 0 TO-DO and 1 NOT ACCESSIBLE

Image 1

Steps to Reproduce

1. Select Visual Disability in Audience Step
2. Add 1 topic in Design Step
3. Add 5 Images of type "Informative" with accessibility "well configured" (Image 1)
   1. Go to Report step and check that "You have achieved your Inclusion Goal" is presented with Visual Disability logo
4. Go back to Design Step and add 1 more topic
   1. Go to Report step and check that presents:
      1. 5 Done; 0 To-do; 0 Not accessible
      2. overall accessibility progress is 50% (wrong)
      3. Go to Report step and check that Topic 1 accessibility progress is 100%
      4. Go to Report step and check that Topic 2 accessibility progress is 0% (wrong)
5. Go back to Program Step and add 1 text component in Topic 2 (or any component with no accessibility settings option)
   1. Go to Report step and check that presents (image 2a and image 2b):
      1. 5 Done; 0 To-do; 0 Not accessible
      2. overall accessibility progress is 50% (wrong)
      3. Go to Report step and check that Topic 1 accessibility progress is 100%
      4. Go to Report step and check that Topic 2 accessibility progress is 0% (wrong)
6. Go back to Program Step and add 1 audio component in Topic 2 and do not configure accessibility
   1. Go to Report step and check that presents:
      1. 5 Done; 0 To-do; 0 Not accessible
      2. overall accessibility progress is 50% (wrong)
      3. Go to Report step and check that Topic 1 accessibility progress is 100%
      4. Go to Report step and check that Topic 2 accessibility progress is 0% (wrong)
7. Go to Program Step and add 1 video component in Topic 2 and do not configure accessibility
   1. Go to Report step and check that presents:
      1. 5 Done; 0 To-do; 0 Not accessible (wrong)
      2. overall accessibility progress is 50% (wrong)
      3. Go to Report step and check that Topic 1 accessibility progress is 100%
      4. Go to Report step and check that Topic 2 accessibility progress is 0%
8. Go back to Program Step and add 3 images component in Topic 2: misconfigure the first as COMPLEX IMAGE, do not configure the second and well configure the third as COMPLEX IMAGE (Image 3)
   1. Go to Report step and check that "You have achieved your Inclusion Goal" is presented with Visual Disability logo (wrong) (the report now is showing a different status, but yet wrong):
      • 7 Done;
      • 1 To-do; (wrong)
      • 1 Not accessible (wrong)
      • overall accessibility progress is 55% (wrong)
      • Go to Report step and check that Topic 1 accessibility progress is 100%
      • Go to Report step and check that Topic 2 accessibility progress is 17% (wrong)

Expected Result:

• step 4 should report same as 3.i. As I just added 1 topic with no content it should not affect accessibility status
• step 5 should report same as 3.i As I just added a component that there is no accessibility settings, it should not affect accessibility status
• step 6 should report same as 3.i As I just add a component that there is no accessibility settings related to VISUAL DISABILITY, it should not affect accessibility status
• step 7 should report: As I just added a component that its accessibility settings are partially related to VISUAL DISABILITY, those accessibility settings options that are related to VISUAL DISABILITY should affect accessibility status
  • 5 Done;
  • 3 To-do;
  • 0 Not accessible
  • overall accessibility progress is 75% (5/8)
  • Topic 1 accessibility progress is 100% (5/5)
  • Topic 2 accessibility progress is 0% (0/3)
• step 8 should report:
  • 7 Done; 5 images from Topic1 and 1 image from Topic2 (2 options)
  • 4 To-do; 1 video (3 options) and 1 image from Topic 2
  • 2 Not accessible 1 image from Topic 2 (2 options)
  • overall accessibility progress is 46,15% (6/13)
  • Topic 1 accessibility progress is 100% (5/5)
  • Topic 2 accessibility progress is 12,5% (1/8)

The course I created to test https://vm2161.kaj.pouta.csc.fi/coursePreview#Ctz4PCgxG2nGrXR9G

Image 2a Image 2b

Image 3a Image 3b

[ecureuill]

Bugs that blocks the use of this feature or generates wrong data

• [x] #176 :bomb:
• [x] #177 :bomb:
• [x] #178 :bomb:

[ecureuill]

• [x] need to fix #11

This bugs could generate wrong datas

• [x] #186
• [x] #187

[CAndresH]

Hello everyone, just review the features that camila has put in the comments and comment if there is any error,

This tool is not finished and there may still be some errors, but I am going to stop making changes in this part for the moment, to dedicate time to other, higher priority requirements,

[ecureuill]

This tool is not finished and there may still be some errors, but I am going to stop making changes in this part for the moment, to dedicate time to other, higher priority requirements,

Ok, @CAndresH I added the label blocked and when you resume the development, just remove it.

[github-actions[bot]]

This feature have been implemented and is ready for Funcional Test. Please, test the feature.

[github-actions[bot]]

Functional Test failed! Please, review your solution.

---

Task from requirement has not been done:

For example: When I select hearing disabilities as an inclusion goal, when I configure the accessibility for video/audio the text transcription should have a "(Required for inclusion)" in its visible label

[CAndresH]

@rebeccamello @caroltaus according to the meeting now the label "(Required for inclusion)" is static for all the audiences that involves text

[github-actions[bot]]

This feature have been implemented and is ready for Funcional Test. Please, test the feature.

[github-actions[bot]]

Functional Test passed! Please, make a PULL REQUEST or, if already merged, close the issue.