/
Inclusive Learning Design Handbook Testing Notes

Inclusive Learning Design Handbook Testing Notes

Jun 06, 2023

Website


Go to this website and find bugs!  http://jhung.github.io/docs-inclusive-learning/

Feature Requests

  • Searching and links to related articles are future improvements

  • Provide a "helper" method or process for adding in the external link identifier. Possibly via docpad helper function, handlebars, etc.

  • It's good to have the 'Topic' anchored to the top. So, it's always available when you scroll down on the page. Specially when you have the topics open, and you start scrolling down, almost half of the screen is occupied by white blank space. And to close the Topics, you should scroll all the way back to the top.

Accessibility Issues

Low:

  • [a11y] currently FF does not read aria-labels on Mac

Fixed:

Usability Issues

Blocker

  • None

High

Medium

Low

  • https://fluidproject.atlassian.net/browse/FLUID-5777

    • The "topics" flag is a collapse/uncollapse toggle, but there's nothing to indicate status, or even "activatability". Perhaps something like a chevron-style arrow that switches back and for between left-facing and right-facing?

    • [mobile] When viewing in mobile, the Topics ribbon should collapse to just the menu icon.

    • [Usability]My initial thought was that Topics was the same as the topbar. I'm not sure if this was because of the two levels of introduction, or if it's the name "Topics" itself

  • Usability - If you close the "Topics" and re-open or open another page it loads open and then closes. It would be better for it to just load closed or to not do the animation.

  • are these kinds of arrows a recommended a11y best-practice? If not, I suggest we do away with them.

    • Yes it actually is recommended for usability. I will find some articles supporting this design. - JH

Fixed

  • The name of the site, "The Inclusive Design Learning Handbook", seems visually a little bit too small. It's smaller than everything else, and given that it's the name, I think it should be a little bit more visible. If someone follows a random link and winds up on some inner page, the "information scent" will not let them know what this site is.

  • The name of the site, under the logo, should probably also be a link to the home page.

  • [content] The logo link should be more descriptive. Right now it just says: "Floe Project"

  • Links in sidebar should not be focusable when sidebar is hidden. This can be solved by adding display:none on the .docs-template-sidebar-visibility class.

  • "Jump to Table of Contents"

    • can be confusing when ToC is enabled via UIO. The label should change.

    • When "Jump to TOC" is selected and the sidebar is closed, focus should jump to the Topics button (or jump near to it)

  • Change the "Edit on Github" link to say "Edit this page on Github"

  • Add aria role="button" to "Topics"

  • a11y - The yellow on teal links at the bottom of the page are kind of hard to read

Content Issues

Blocker:

Medium:

  • content - Should the Get Involved text or maybe the README talk about how to submit pull requests and etc. to get edits into the ILDH.

  • content - Should the "Who is this for" section go ahead of "Get Involved"

Fixed:

  • [content] On the Methods - Inclusive Learning page, the "CC- By Education" external link lacks the arrow

  • [content] Some images are missing - this is because relative url helper was not being used.

  • Content - in Inclusive EPUB 3, Missing word "to" in the sentence:

    • The information provided illustrates how concepts may be applied but won't make you an "expert" - you are encouraged use this guide as a starting point and to follow the resources provided to gain additional insight. 

  • content - It seems a bit strange to have an Introduction in the Introduction. Can we rename / reorganize this sub-section.

  • Content - In Inclusive Learning The heading "Solutions: customization + personalization, demands + matching" is hard to read and confusing because of the wrapping.

  •  "Accessible Standardized Testing" and "Inclusive EPUB 3" have a different structure than the "Introduction" and "Methods" groups in that they open to a page that isn't in the topics.

  • [Content]The external links in the footer have an arrow, to indicated their externalness, but external links within the content don't have the arrow.

    • Verify if this is true or which page this was on.

    • Some external links were missing arrows - should be fixed now.

UIO Issues

Blocker:

  • None

Investigate:

Fixed:

  • [UIO / CSS] When in Contrast mode, hover border on TOC does not match scheme

  • [UIO] The Nav container and tagline background colour needs to be updated for contrast themes.

  • [UIO] Tell the TOC enactor to omit section

    • I'm not sure if the point above refers to this, but: The ToC contains links it shouldn't: It always starts with a link to "The Inclusive Learning Design Handbook", and most pages also have a link "Introduction". These links appear before the links that belong. FIXED

    • [Content] a clickable item appears next to the logo. You can hover over it and selecting it does nothing. Windows Only? Happens in IE 11 and FF. Chrome on Windows is fine. FIXED

  • [UIO] The link 'underline and bold' action is not underlining the left-navbar links. FIXED

Styling Issues

Blocker:

  • none

Low:

Fixed:

  • [css] Focus styling on UIO button is blue. It should match the green used for background (same styling as the skip links)

  • [css] Focus styling on the "current page" link in the left sidebar is almost invisible

  • [css] There seems to be no hover style for the active item in the horizontal nav, even though it's still

  • [css] When focus appears on nav or TOC item with a hover state, you see gaps between the rounded border and the outline

  • [css] The Topics ribbon is just a *hair* too narrow.

    • [CSS/Styling] Topcis ribbon is jagged - fixed

  • It maybe good to have consistent focus styles for the tabs on top and the Topics list items

  • There us a white rectangle that appears under the Topics link when you select it that doesn't go away. I don't know if this is intentional or not (It goes away when you select another tab from the top row)

    • This was a problem after activating the UIO Table of Contents. This has been fixed.

  • [css] The contents of the "Topics" section move up to the left when closing.

    • This is no longer a problem because the transition has been removed because of a bug.

 

Browser Specific Issues

Low:

  • css - Menu icon can sometime not appear on Chrome 44.0.2.

  • [browser] DroidSans used in Floe logo does not show up on IE latest

  • [Browser] In IE, OpenSans bold (or weighted style) does not render. It defaults to Times Roman. This may be a known bug already. Check Jira.

Mobile

Blocker:

Medium:

Low:

Investigate:

  • The tabs on the top row don't seem to be clickable and don't look like tabs.

Sep 2015 testing

Chrome testing results

==================

 

 Fixed:

Issues:

 

  1. Dead Links

    1. https://jhung.github.io/docs-inclusive-learning/WhatIsTheApproach.html

      1. Accessibility principles

    2. https://jhung.github.io/docs-inclusive-learning/AccessibilityPrinciples.html

      1. inclusive learning

      2. LearnerNeedsAndPreferences (the words should also be separated by a space)

      3. authoring content

      4. Video content and learning

      5. Audio content and learning

      6. Cognitive considerations

    3. https://jhung.github.io/docs-inclusive-learning/Techniques.html

      1. metadata

      2. AccessForAll ( should these be separate words? )

      3. Learner Options

      4. Authoring of content

    4. https://jhung.github.io/docs-inclusive-learning/Metadata.html

      1. AccessForAll

      2. Schema.org Accessibility Properties

      3. live demo of the current version of the Floe metadata authoring tools

    5. https://jhung.github.io/docs-inclusive-learning/LearnerNeedsAndPreferences.html

      1. inclusive learning

      2. Accessibility principles

      3. link to “Figure: A screen of the Floe Video player with transcripts displayed”

      4. Audio content and learning

      5. Video content and learning

      6. link to “Figure: Landscape of alternatives, transformations and customizations”

    6. https://jhung.github.io/docs-inclusive-learning/VideoContentAndLearning.html

      1. Learner needs and preferences

      2. Floe video player

    7. https://jhung.github.io/docs-inclusive-learning/AudioContentAndLearning.html

      1. Video content and learning

      2. Learner needs and preferences

    8. https://jhung.github.io/docs-inclusive-learning/AuthoringOfContent.html

      1. Metadata

      2. Learner needs and preferences

      3. Audio content and learning

      4. Video content and learning

    9. https://jhung.github.io/docs-inclusive-learning/AccessibleStandardizedTesting.html

      1. General Guidelines

      2. Functional Considerations

      3. Standardized Test Types

      4. Standardized Test Tools

    10. https://jhung.github.io/docs-inclusive-learning/SemanticMarkupInEPUB3.html

      1. "EPUB 3 semantic tags” - by Helicon Books

    11. https://jhung.github.io/docs-inclusive-learning/WAI-ARIA.html

      1. Mathematics

    12. https://jhung.github.io/docs-inclusive-learning/Mathematics.html

      1. Cognitive considerations

    13. https://jhung.github.io/docs-inclusive-learning/NarrationsAndTextToSpeech.html

      1. Case study: Exemplar

    14. https://jhung.github.io/docs-inclusive-learning/EPUB3Resources.html

      1. http://www.heliconbooks.com/article/epub3vshtml5

      2. MathJax.org (gets a 404 and redirects to main site)

    15. clicking "Edit this Page on GitHub" link leads to a github 404 error page. Will this issue be gone once the branch is merged into the master. If yes, please ignore this item.

      There are some other broken links, such as these links on the page https://jhung.github.io/docs-inclusive-learning/AccessibleStandardizedTesting.html:

      "General Guidelines"

      "Functional Considerations"

      "Standardized Test Types"

      "Standardized Test Tools"

 

 

Safari 7.1.8 on Mac 10.9.5 results 

Things that look strange or broken:

 - I do note that when topics hidden, it’s actually not bad to have quick access to the ‘show’ link.