Open lmock opened 7 years ago
@stezel I'll take care of the two Optional Projects issues; can you take care of the others?
@lmock @maryfries There were some missing titles for links I took care of those, but it is not clear to me how to make a link more descriptive than giving the title of the page it is linking to. I need some examples to make sense of these suggestions.
Here's what I think might be an example...
Here's 2.1.1 as it was:
Here's are two suggested methods for correction: or
@lmock can you please confirm if these meet the need and let us know if you/UCB have/has a preference between the two methods (in general—not just here)?
@stezel if Lauren approves of both and has no preference, can you see if Paul does?
Thank you both!
I vote for the sidenote version. That sentence is too long already! :-)
On 10/30/17 11:36 AM, Mary wrote:
Here's what I think might be an example...
Here's 2.1.1 as it was:
Here's are two suggested methods for correction: or
@lmock can you please confirm if these meet the need and let us know if you/UCB have/has a preference between the two methods (in general—not just here)?
@stezel if Lauren approves of both and has no preference, can you see if Paul does?
Thank you both!
Paul agrees that the sidenote is better. I'll sync it. Let's wait for an OK from Lauren before implementing throughout. Thanks!
We have perhaps a hundred ( more ?) links in the curriculum that refers back to different parts of the curriculum. Sometimes in a single sentence we have multiple references to different parts of the curriculum. Are we suggesting that each of these references are recreated in this yellow box format? Do we know that these extra boxes are helpful in the ADA situation?
I don’t know about whether side notes help or harm from the perspective of ADA. I have never been convinced that the cross-referencing adds utility and I am convinced that it reduces readability. Ultimately, we need some kind of index, but that is not a priority for now.
My strong advice would be not to try going through the entire curriculum to “correct” this from in-text references to sidenotes now. Instead, we should think and talk about what is a good general solution (in my mind, that’s an index, but we should all get to think about that), and only then, if we have time, implement it. Otherwise, we’re doing ad hoc fixes that we might later wind up rethinking and having to re-do.
—P
From: stezel notifications@github.com<mailto:notifications@github.com> Reply-To: bjc-edc-2017-18/bjc-r reply@reply.github.com<mailto:reply@reply.github.com> Date: Monday, October 30, 2017 at 12:06 PM To: bjc-edc-2017-18/bjc-r bjc-r@noreply.github.com<mailto:bjc-r@noreply.github.com> Cc: Subscribed subscribed@noreply.github.com<mailto:subscribed@noreply.github.com> Subject: Re: [bjc-edc-2017-18/bjc-r] U2 ADA Fixes (#12)
We have perhaps a hundred ( more ?) links in the curriculum that refers back to different parts of the curriculum. Sometimes in a single sentence we have multiple references to different parts of the curriculum. Are we suggesting that each of these references are recreated in this yellow box format? Do we know that these extra boxes are helpful in the ADA situation?
— You are receiving this because you are subscribed to this thread. Reply to this email directly, view it on GitHubhttps://github.com/bjc-edc-2017-18/bjc-r/issues/12#issuecomment-340494186, or mute the threadhttps://github.com/notifications/unsubscribe-auth/AKrnasdC6lfrvuu6VvBgJ72URsOgT-kaks5sxfQYgaJpZM4QGC_H.
There's honestly no way to know what's best, because what we're dealing with is an opinion. Frankly, it's one I think is misleading. This page has the official description of what the rule means.
https://www.w3.org/TR/UNDERSTANDING-WCAG20/navigation-mechanisms-refs.html
The sections for success criterion and failures. The wording is all quite ambiguous because there's (obviously) no good test of when content is perfectly clear.
Note that the description uses the word "purpose". So far in all their communication, it seems like Berkeley is fixated on the destination of a link. To me, that's completely at odds with what the standards are. If they're not following standards, then we're just guessing blindly at what to fix.
IMO, the current version is better because it describes why you'd be going to a new page. (i.e. The text "loops" is more indicative of why you'd visit a page than a page title describing a ton of different actions.)
The reason Berkeley thinks the links are good is because a screen reader user will often navigate a page out of context. (for example, by looking only at the headings, and then only at the links.) in that case, the sidetone version would accomplish that better because it's more descriptive and the order isn't too important.
However, if a SR user is reading a page linearly, then the sidetone version is more difficult to use because the ordering of the page and text isn't as clear. (Assuming they need that link.)
But, ultimately the coherence of the content matters most. It's absolutely daft to make sentences more confusing for 100% of users just to have more verbose links. That is, ironically and infuriatingly, it's own accessibility issue.
In the end: I think the sidetone is better because the actual text is the most clear. I don't know that all the back links are that necessary, but they do seem like a nice thing to be able to have.
However, perhaps the solution is to use them in the EDC curriculum but not in edX. The audit and rules only matter for the edX site.
Please also tag me on issues (or assign them to me) if there's some confusion and then I'll see it. But I don't get notifications for the repo.
@stezel @maryfries sorry for the late reply. I think the in-line version is better for accessibility than the side note version, however Berkeley doesn't seem to have a problem with side notes.
@maryfries Hi Mary, I have addressed all these except the last two issues on color contrast and table fix for the optional projects. I cannot tell from the html of the pages if you were able to address these. Please let me know so I can close this thread.
@cycomachead are the red/yellow/green text colors now on http://localhost/bjc-r/cur/programming/2-complexity/optional-projects/1-magic8ball.html now ok? Brian made some edits.
I think the red and yellow on most backgrounds will still be problematic. This page makes it easy to check (you need to hit a value of 4.5) https://contrast-ratio.com/#%231b827f-on-white
@brianharvey I suggest we just remove the color. There is no need to show kids what color red, yellow, and green are (unlike some of those HEX colors). Everyone knows. :)
@brianharvey can you look at my suggestion from 10/3/18: just remove the color. Can I just do that and close this issue?
Needs more descriptive links & fixing tables
[x] U2L1 P1: Link labeled “looping” goes to page titled “Looping with a Counter” https://github.com/bjc-edc-2017-18/bjc-r/blob/gh-pages/cur/programming/2-complexity/1-variables-games/1-number-guessing-game.html
[x] U2L2 P2: Linked labeled, “Ongoing Discussion” is not descriptive. https://github.com/bjc-edc-2017-18/bjc-r/blob/gh-pages/cur/programming/2-complexity/2-data-structures-art/2-data-types.html
[x] U2L3 P2: Link titled “Export” goes to page “Importing Greet Player into Another Program” Link titled “your U2L3-Predicates project” goes to page titled “What’s a Predicate?” Links titled “the” and “block” - it is not obvious that "for" is also hyperlinked because of the colored text. https://github.com/bjc-edc-2017-18/bjc-r/blob/gh-pages/cur/programming/2-complexity/3-predicates/2-keeping-list-items.html
[x] U2L3 P3: Link labeled “this word puzzle” can be renamed “BJC Unit 2 Lab 3 Word Puzzle” https://github.com/bjc-edc-2017-18/bjc-r/blob/gh-pages/cur/programming/2-complexity/3-predicates/3-solving-word-puzzle.html
[x] U2L4 P2 Link labeled “Import” goes to page titled “Importing Greet Player into Another Program” Link labeled “block” goes to page titled “Keeping Items From a List” Link labeled “exporting and importing” goes to page titled “Importing Greet Player into Another Program” https://github.com/bjc-edc-2017-18/bjc-r/blob/gh-pages/cur/programming/2-complexity/4-abstraction/3-brick-wall.html
[ ] U2 Optional Projects: Automated Fortune Teller Change the background color on the colors green, yellow, and red so they have the 4.5:1 color contrast ratio for: "(green), five are non-committal (yellow), and five are negative (red)" https://github.com/bjc-edc-2017-18/bjc-r/blob/gh-pages/cur/programming/2-complexity/optional-projects/1-magic8ball.html
[x] U2 Optional Projects: Egyptian Motif - Fix the Table (scope, caption, headings) https://github.com/bjc-edc-2017-18/bjc-r/blob/gh-pages/cur/programming/2-complexity/optional-projects/2-egyptian-motif.html