Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Cleaning up a lot of little link errors #741

Merged
merged 17 commits into from
Mar 22, 2024
Merged
Show file tree
Hide file tree
Changes from 15 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions _guide/design.md
Original file line number Diff line number Diff line change
Expand Up @@ -47,14 +47,14 @@ Worldwide, government website design is being led by open source initiatives.
* [Okta's Odyssey Design System](https://github.com/okta/odyssey)
* [IBM's Carbon open source design system](https://www.carbondesignsystem.com/) - [Carbon on GitHub](https://github.com/carbon-design-system/carbon) [Carbon's Accessibility](https://www.carbondesignsystem.com/guidelines/accessibility/overview/) - Uses Web Components
* [Impact Design System](https://demos.creative-tim.com/impact-design-system/index.html) - [Impact Desigh System on GitHub](https://github.com/creativetimofficial/impact-design-system)
* [VMWare's Clarity Design System](https://clarity.design/) - [Clarity on GitHub](https://github.com/vmware/clarity) [Clarity's Accessibility](https://clarity.design/get-started/support/#accessibility-support) - Uses Web Components
* [VMWare's Clarity Design System](https://clarity.design/) - [Clarity on GitHub](https://github.com/vmware/clarity) [Clarity's Accessibility](https://clarity.design/get-started/support/) - Uses Web Components
* [Emulsify](https://www.emulsify.info/) - [Emulsify on GitHub](https://github.com/emulsify-ds) [Emulsify's Accessibility](https://docs.emulsify.info/usage/accessibility-testing)
* [ING's Lion Design System](https://lion-web-components.netlify.app/?path=/story/*) - [Lion on GitHub](https://github.com/ing-bank/lion) [Lion's Accessibility](https://lion-web.netlify.app/blog/ing-open-sources-lion/#accessibility) - Uses Web Components
* [Talend's Coral Design System](https://design.talend.com/) - [Coral on GitHub](https://github.com/Talend/ui/) - Uses React Components
* [Orange Digital Accessibility](https://a11y-guidelines.orange.com/en/) - [Orange a11y-guidelines on GitHub](https://github.com/Orange-OpenSource/a11y-guidelines)
* [Google's Material Design](https://material.io/) - [Material on GitHub](https://github.com/material-components) [Material's Accessibility](https://material.io/design/usability/accessibility.html#understanding-accessibility) - Uses Web Components
* [Google's Material Design](https://material.io/) - [Material on GitHub](https://github.com/material-components) [Material's Accessibility](https://material.io/design/usability/accessibility.html) - Uses Web Components
* [Adobe's Spectrum](https://spectrum.adobe.com/) - [Spectrum's Inclusive Design](https://spectrum.adobe.com/page/inclusive-design/) - Uses Web Components
* [Microsoft's Fluent](https://www.microsoft.com/design/fluent/#/) [Fluent UI on GitHub](https://github.com/microsoft/fluentui)
* [Microsoft's Fluent](https://www.microsoft.com/design/fluent/) [Fluent UI on GitHub](https://github.com/microsoft/fluentui)
* [Bridge Lab's Bold](https://bold.bridge.ufsc.br/en/) - [Bold on GitHub](https://github.com/laboratoriobridge/bold) [Bold's Accessibility](https://bold.bridge.ufsc.br/en/design-guidelines/accessibility/)
* [Shopify's Polaris](https://polaris.shopify.com/) - [Polaris on GitHub](https://github.com/topics/shopify-polaris) [Polaris' Accessibility](https://polaris.shopify.com/foundations/accessibility)
* [Intuit's Design-systems-cli](https://intuit.github.io/design-systems-cli/) - [Intuit on GitHub](https://github.com/intuit/design-systems-cli) [Quickbooks' Accessibility](https://designsystem.quickbooks.com/bolt/accessibility/)
Expand Down
2 changes: 1 addition & 1 deletion _guide/plain-language.md
Original file line number Diff line number Diff line change
Expand Up @@ -68,7 +68,7 @@

### Test your content with a readability tool

Always run your content through a readability tool. You can use [Hemingway App](http://www.hemingwayapp.com/), [Readable.io](https://readable.io/), or [turn on Flesch-Kincaid](https://support.microsoft.com/en-us/topic/get-your-document-s-readability-and-level-statistics-85b4969e-e80a-4777-8dd3-f7fc3c8b3fd2) if editing in Microsoft Word. Try to get the reading grade level lower than 8th grade. Before using the tool, remember to remove:
Always run your content through a readability tool. You can use [Hemingway App](https://www.hemingwayapp.com/), [Readable.io](https://readable.io/), or [turn on Flesch-Kincaid](https://support.microsoft.com/en-us/topic/get-your-document-s-readability-and-level-statistics-85b4969e-e80a-4777-8dd3-f7fc3c8b3fd2) if editing in Microsoft Word. Try to get the reading grade level lower than 8th grade. Before using the tool, remember to remove:

Check warning on line 71 in _guide/plain-language.md

View workflow job for this annotation

GitHub Actions / remark-lint

[remark-lint] _guide/plain-language.md#L71

Expected `1` space between sentences, not `2` space retext-sentence-spacing
Raw output
    71:341-71:343  warning  Expected `1` space between sentences, not `2`              space                        retext-sentence-spacing
dmundra marked this conversation as resolved.
Show resolved Hide resolved

* proper nouns
* titles
Expand Down
4 changes: 2 additions & 2 deletions _guide/resources.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ General and digital-specific accessibility books we recommend.
* [Agile Accessibility Explained](https://www.amazon.com/Agile-Accessibility-Explained-sustainable-development/dp/1689182733/ref=sr_1_2?dchild=1&keywords=Agile+Accessibility+Explained&qid=1615337578&sr=8-2) Dylan Anthony Barrell
* [Design for Real Life](https://abookapart.com/products/design-for-real-life) - Sara Wachter-Boettcher and Eric Meyer
* [Designing Connected Content: Plan and Model Digital Products for Today and Tomorrow](https://www.amazon.com/Designing-Connected-Content-Products-Tomorrow/dp/0134763386) - Mike Atherton
* [End of Average](http://www.toddrose.com/endofaverage) - Todd Rose
* [End of Average](https://www.toddrose.com/endofaverage) - Todd Rose
* [Inclusive Design for a Digital World: Designing with Accessibility in Mind](https://www.amazon.com/Inclusive-Design-Digital-World-Accessibility/dp/148425015X) - Regine M. Gilbert
* [Inclusive Design Patterns](https://www.amazon.com/Inclusive-Design-Patterns-Heydon-Pickering-ebook/dp/B01MAXK8XR) - Heydon Pickering
* [Mismatch: How Inclusion Shapes Design](https://mitpress.mit.edu/books/mismatch) - Kat Holmes
Expand All @@ -42,7 +42,7 @@ General and digital-specific accessibility books we recommend.
* [A11yweekly.com](https://a11yweekly.com/) by David A. Kennedy
* [Accessibility Matters Newsletter](https://www.accessibilityassociation.org/content.asp?contentid=167) - by the IAAP
* [Microassist's Accessibility in the News](https://www.microassist.com/digital-access/news/) - by Jack McElaney
* More available from [WebAxe who maintains a terrific list](http://www.webaxe.org/digital-accessibility-newsletters/)
* More available from [WebAxe who maintains a terrific list](https://www.webaxe.org/digital-accessibility-newsletters/)


## Podcasts {#podcasts}
Expand Down
16 changes: 7 additions & 9 deletions _guide/tools.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ Digital accessibility tools.

## Authoring {#authoring}

* [A11yFirst for CKEditor](http://a11yfirst.web.illinois.edu/) - [Accessibility First on GitHub](https://github.com/a11yfirst/distribution) \
* [A11yFirst for CKEditor](https://a11yfirst.web.illinois.edu/) - [Accessibility First on GitHub](https://github.com/a11yfirst/distribution) \
Series of plugins for supporting a11y best practices within the WYSIWYG editor, CKEditor.
* [Sa11y, the accessibility quality
assurance assistant](https://sa11y.netlify.app/) \
Expand All @@ -26,7 +26,7 @@ A plugin for [retext](https://github.com/retext-project/retext) that scans text
Another plugin for [retext](https://github.com/retext-project/retext) that checks text content for possible insensitive, inconsiderate language.
* [Zettlr: Markdown Editor](https://www.zettlr.com/) - [Zettlr on GitHub](https://github.com/Zettlr/Zettlr) \
Open source Markdown editor that simplifies the content creation experience by avoiding the clutter seen in many common word processing solutions.
* [Drupal](http://drupal.org/) is a very accessible CMS and [these modules can enhance its accessibility](https://accessibility.civicactions.com/guide/resources#drupal-accessibility-modules)
* [Drupal](https://drupal.org/) is a very accessible CMS and [these modules can enhance its accessibility](https://accessibility.civicactions.com/guide/resources#drupal-accessibility-modules)
* [ATOM Plugin - web-accessibility-checker package](https://atom.io/packages/web-accessibility-checker) An accessibility \
Plugin for the popular open source ATOM Editor from GitHub.

Expand Down Expand Up @@ -77,11 +77,11 @@ This tool runs a set of tests against a set of URLs to verify whether each one m
Extremely flexible and popular testing suite from Google that can be run directly on pages, from the command line, or as a Node module.
* [IBM Equal Access Toolkit](https://www.ibm.com/able/toolkit/) - [equal-access on GitHub](https://github.com/IBMa/equal-access) \
Tools from IBM that can automate accessibility testing from a browser, or when added to a continuous integration environment.
* [Explore ARIA Landmarks Browser Extension](http://matatk.agrip.org.uk/landmarks/) - [Landmarks on GitHub](https://github.com/matatk/landmarks) \
* [Explore ARIA Landmarks Browser Extension](https://matatk.agrip.org.uk/landmarks/) - [Landmarks on GitHub](https://github.com/matatk/landmarks) \
Browser extension that allows you to navigate a web page via WAI-ARIA landmarks, using the keyboard or a pop-up menu.
* [Firefox AInspector WCAG](https://addons.mozilla.org/en-US/firefox/addon/ainspector-wcag/) - A Firefox Add-on that addresses accessibility compliance \
using OpenAjax Alliance rulesets.
* [Qualweb](http://qualweb.di.fc.ul.pt/evaluator/) - [Qualweb on GitHub](https://github.com/qualweb) - A set of tools that are being built to align with the W3C's ACT ruleset.
* [Qualweb](https://qualweb.di.fc.ul.pt/evaluator/) - [Qualweb on GitHub](https://github.com/qualweb) - A set of tools that are being built to align with the W3C's ACT ruleset.

## Bookmarklets {#bookmarklets}

Expand All @@ -108,9 +108,9 @@ Evaluate WAI-ARIA according to the [ARIA in HTML](https://www.w3.org/TR/html-ari
* [Contrast Finder by Tanaguru](https://contrast-finder.tanaguru.com/) - [Contrast Finder GitHub Page](https://github.com/Tanaguru/Contrast-Finder)
* [Contrast-Ratio.com](https://contrast-Ratio.com) - [Contrast-Ratio GitHub Page](https://github.com/siege-media/contrast-ratio) \
Allows for testing of contrast of text on top of a semi transparent background.
* [Contrast Checker](https://contrast-checker.glitch.me/) - [Contrast Checker on Glitch](https://glitch.com/edit/#!/contrast-checker?path=server.js%3A1%3A0)
dmundra marked this conversation as resolved.
Show resolved Hide resolved
* [Contrast Checker](https://contrast-checker.glitch.me/) - [Contrast Checker on Glitch](https://glitch.com/edit/#!/contrast-checker)
* [ButtonBuddy](https://buttonbuddy.dev/) - [ButtonBuddy on GitHub](https://github.com/5t3ph/buttonbuddy)
* [ACD (Previously ColorCube)](http://accessiblecolor.design) - [ColorCube on GitHub](https://github.com/oomphinc/colorcube)
* [ACD (Previously ColorCube)](https://accessiblecolor.design) - [ColorCube on GitHub](https://github.com/oomphinc/colorcube)
* [LeonardoColor.io](https://leonardocolor.io/#) - [Leonardo on GitHub](https://github.com/adobe/leonardo)
* [Colour Contrast Checker](https://colourcontrast.cc) - [Colour Contrast Checker on GitHub](https://github.com/Pushedskydiver/Colour-Contrast-Checker)
* [Who Can Use](https://whocanuse.com/) - [Who Can Use on GitHub](https://github.com/CoreyGinnivan/whocanuse)
Expand Down Expand Up @@ -169,13 +169,11 @@ Testing with [Nightwatch](https://nightwatchjs.org/) on GitHub
Simulates color blindness, low vision, dyslexia and more.
* [Funkify Chrome Extension](https://www.funkify.org/) \
Not open source, but a free version is available which simulates dyslexia and cognitive/motor/vision conditions.
* [ChromeLens Extension](http://chromelens.xyz/) - [ChromeLens on GitHub](https://github.com/chromelens/chromelens) \
Chrome extension that offers vision simulators, testing, and a tab focus order visualizer.
* [Sim Daltonism](https://michelf.ca/projects/sim-daltonism/) - [sim-daltonism on GitHub](https://github.com/michelf/sim-daltonism/) \
iOS/Mac app that lets you visualize colors as they are perceived with various types of color blindness.
* [A11Y: Color blindness empathy test](https://vinceumo.github.io/A11Y-Color-Blindness-Empathy-Test/) [on GitHub](https://github.com/vinceumo/A11Y-Color-Blindness-Empathy-Test-browser-extensions)
Chrome/Firefox extension and a web-based tool created to help designers and developers better understand color blindness and visual imparity.
* [Color Oracle](http://colororacle.org/) - [Oracle-Mac on GitHub](https://github.com/nvkelso/color-oracle) & [Oracle-Windows on GitHub](https://github.com/nvkelso/color-oracle-java) \
* [Color Oracle](https://colororacle.org/) - [Oracle-Mac on GitHub](https://github.com/nvkelso/color-oracle) & [Oracle-Windows on GitHub](https://github.com/nvkelso/color-oracle-java) \
Color blindness simulator for Windows, Mac, and Linux.

## EPUB3 {#epub}
Expand Down
2 changes: 1 addition & 1 deletion _playbook/automated-testing.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ Government Digital Services in both the [United Kingdom](https://github.com/alph
However, it is important to note that, no matter the tool, [automated testing only catches about one third of accessibility issues](https://alphagov.github.io/accessibility-tool-audit/), so it cannot be relied upon to determine if a site complies. To better ensure that their digital tools are accessible to keyboard-only and assistive technology users, automated tests need to be done along with a robust manual testing plan.

List of popular automated testing tools
* [Wave](http://wave.webaim.org/extension/)
* [Wave](https://wave.webaim.org/extension/)
* [Tenon](https://tenon.io/)
* [SiteImprove](https://chrome.google.com/webstore/detail/siteimprove-browser-exten/amoojkmllfodlpgmdnclkgdnejgpeada)
* [See more tools in our guide](/guide/tools)
Expand Down
4 changes: 2 additions & 2 deletions _playbook/checklists.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ One could also look to use a tool like WebAim's WAVE, ANDI, or Tota11y to scan a
* See if the alt text effectively describes the images on the page.
* Ensure that there is sufficient color contrast.
* Do keyboard only testing (using just tab, shift-tab, arrow keys & escape) to navigate the page.
* Evaluate page for plain language using free tools like the [HemingwayApp](http://www.hemingwayapp.com/).
* Evaluate page for plain language using free tools like the [HemingwayApp](https://www.hemingwayapp.com/).
* Magnify the page up to 200% and look for usability and readability issues.

There are lots of checklists, rotating through a few of them will help give different people different things to think about accessibility:
Expand All @@ -43,7 +43,7 @@ There are lots of checklists, rotating through a few of them will help give diff
* [Elsevier's WCAG 2.1 Checklist](https://romeo.elsevier.com/accessibility_checklist/)
* [A11yProject](https://www.a11yproject.com/checklist/)
* [Heydon Works](https://github.com/Heydon/inclusive-design-checklist)
* [VoxMedia](http://accessibility.voxmedia.com/)
* [VoxMedia](https://accessibility.voxmedia.com/)
* [PSU](https://accessibility.psu.edu/checklist/)
* [Yale](https://usability.yale.edu/web-accessibility/articles/wcag2-checklist)
* [University of Washington](https://www.washington.edu/accessibility/checklist/)
Expand Down
2 changes: 1 addition & 1 deletion _playbook/roles.md
Original file line number Diff line number Diff line change
Expand Up @@ -56,7 +56,7 @@ We've taken these lists, added other roles that we didn't see included and inclu
## Content Author / Writer
* See: [USA: Accessibility for content designers](https://accessibility.digital.gov/content-design/getting-started/)
* W3C WAI - [ARRM Project: Accessibility Roles and Responsibilities Mapping](https://www.w3.org/WAI/EO/wiki/Content_Author_Responsibilities_Mapping).
* **Tools:** [Sa11y](https://ryersondmp.github.io/sa11y/), [Editoria11y](https://itmaybejj.github.io/editoria11y/), [retextjs](https://github.com/retextjs) and [HemingwayApp](http://www.hemingwayapp.com/)
* **Tools:** [Sa11y](https://ryersondmp.github.io/sa11y/), [Editoria11y](https://itmaybejj.github.io/editoria11y/), [retextjs](https://github.com/retextjs) and [HemingwayApp](https://www.hemingwayapp.com/)
* Checklist:
* Does the content meet your readability target?
* Are there any [unusual words](https://www.w3.org/WAI/WCAG21/quickref/?versions=2.0#unusual-words) to watch for?
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -169,4 +169,4 @@ You should keep tweaking the tools and double-check your content to make sure it
* [Readability Check](https://marketplace.visualstudio.com/items?itemName=jemcclin.readabilitycheck).
* [status-stats-jbrains package](https://atom.io/packages/status-stats-jbrains).

Thank you to [Michelle Kang](/about/people/michelle-kang), [Marlena Medford](https://civicactions.com/team/marlena-medford), [Luke Fretwell](/about/people/luke-fretwell), and [Mike Gifford](/about/people/mike-gifford) for your support, thoughts, and feedback.
Thank you to Michelle Kang, Marlena Medford, Luke Fretwell, and Mike Gifford for your support, thoughts, and feedback.
Original file line number Diff line number Diff line change
Expand Up @@ -159,7 +159,7 @@ started](https://www.microassist.com/digital-accessibility/the-value-of-
digital-accessibility-statements-a-checklist-for-getting-started/).

The W3C has an [accessibility statement
generator](https://www.w3.org/WAI/planning/statements/generator/#create) which
generator](https://www.w3.org/WAI/planning/statements/generator) which
adds in section for technical information that might help a user better
navigate the site. [Disability:IN](https://disabilityin.org/resource/digital-
accessibility-statement-best-practices/) and the UK's [Government Digital
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -60,7 +60,7 @@ widespread.

**Resources**

* [Presentation Slide Deck](https://docs.google.com/presentation/d/1S_K8VcxJ6_IQJ1dT4YJmq3GsMkWAkCU7kavImugu3KI/edit#slide=id.ga784c5ac4b_0_358)
* [Presentation Slide Deck](https://docs.google.com/presentation/d/1S_K8VcxJ6_IQJ1dT4YJmq3GsMkWAkCU7kavImugu3KI)
* [Presentation Overview](https://events.drupal.org/europe2020/sessions/top-cms-tools-are-working-together-build-more-inclusive-world)
* [We4Authors](https://accessibilitycluster.com/)
* [About Funka](https://www.funka.com/en/about-funka2/)
Expand Down
2 changes: 1 addition & 1 deletion _posts/2023-02-01-governments-accessibility-opensource.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,6 @@ roles:
- Operations
---

I presented [Governments, accessibility and open source](https://www.meetup.com/inclusive-design-accessibility/events/291069715/) in Utrecht. My [slides are available](https://docs.google.com/presentation/d/1Pm0bVAZwk_NBxeOMvjiTtTXTQBumZjwNgb6MDLDXwSE/edit#slide=id.gde6e9fa718_0_3), and we hope to make the audio available soon.
I presented [Governments, accessibility and open source](https://www.meetup.com/inclusive-design-accessibility/events/291069715/) in Utrecht. My [slides are available](https://docs.google.com/presentation/d/1Pm0bVAZwk_NBxeOMvjiTtTXTQBumZjwNgb6MDLDXwSE), and we hope to make the audio available soon.

My talk focused on some of the challenges that governments are facing as they work to modernize and adopt modern digital first practices. In my talk I address Open Government, open source software and Civic Tech. I highlight how digital accessibility is a huge challenge for governments. Often innovation clashes with inclusive design. There is new legislative pressure on governments, and governments are always struggling to do more with less.
2 changes: 1 addition & 1 deletion _posts/2023-02-05-FOSDEM-ccessibility-OpenSource.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ roles:
- Developer
---

I presented on February 5th in the Design track of the conference. The [slides](https://docs.google.com/presentation/d/1lkUM9mkBSgH0-8pf-kDtPp-FxTCxKEaWd7ze8wA3NA0/edit#slide=id.gde6e9fa718_0_3) and [presentation](https://fosdem.org/2023/schedule/event/accessibility_and_open_source/) are available to those who missed it.
I presented on February 5th in the Design track of the conference. The [slides](https://docs.google.com/presentation/d/1lkUM9mkBSgH0-8pf-kDtPp-FxTCxKEaWd7ze8wA3NA0/) and [presentation](https://fosdem.org/2023/schedule/event/accessibility_and_open_source/) are available to those who missed it.

My presentation focused on my experience in Drupal. Drupal has been a leader in digital accessibility for over an decade. Working with an open community has allowed us to pioneer some new solutions to common design challenges. Working in the open has allowed us to tap expertise outside of our community and given space for people with disabilities to become involved in a variety of roles. Accessibility best practices make it clear that accessibility needs to be considered at all levels of a project.

Expand Down
Loading
Loading