From ad562c6e4fd3008e38f33431be475b48f67ffe6e Mon Sep 17 00:00:00 2001 From: Mike Gifford Date: Wed, 30 Oct 2024 11:31:09 -0400 Subject: [PATCH] Accessibility 2024 Chapter (#3809) * Update accessibility.md - In Progress Initial commit to ensure I capture what I have done so far. Working on the alt text now. * Update accessibility.md removing the encapsulated images. * Update accessibility.md Adding an example chart * Update accessibility.md removing legacy link * Update accessibility.md Updating overlay content * Update accessibility.md Highlighted numbers * Update accessibility.md Filling out all of the remaining big numbers * Update accessibility.md adding in more images and setting defaults for others * Update accessibility.md Filling in more content. Up tp user preferences. * Update accessibility.md Adding mroe graphs * Update accessibility.md Up to alt-altribute-lengths * Update accessibility.md Getting to the States * Update accessibility.md All of the images and alt text. * Update contributors.json Adding myself to contributor.json file along with the article. * Update contributors.json Adding other contributors. * Update accessibility.md Making some minor text changes and filling in the featured metadata. * Update accessibility.md removing trailing slashes. * Update accessibility.md Updating authors, reviewers and analysts. * Update accessibility.md Removing remaining "\." and fixing white spaces. * Update contributors.json fixing a linting error * Update contributors.json Removing commas for linter * Update contributors.json Adding Jonathan's website. * Update accessibility.md (#3814) Minor typos * Fixes to allow chapter to generate * Add images * Optimised images with calibre/image-actions * Markup fixes * Smart quotes * Table markup * Add image * Optimised images with calibre/image-actions * Fix links * Formatting * Formatting * Accessible images * Optimised images with calibre/image-actions * Retake images * Map images * Final edits * Final, final edits --------- Co-authored-by: Jonathan Pagel <63317370+jcmpagel@users.noreply.github.com> Co-authored-by: Barry Pollard Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> --- src/config/2024.json | 3 +- src/config/contributors.json | 61 + src/content/en/2024/accessibility.md | 1122 ++++++++++++++++- src/server/config.py | 2 +- .../US-state-governments-map.png | Bin 0 -> 29325 bytes .../accessibility/US-state-governments.png | Bin 0 -> 46001 bytes .../accessibility/a11y-app-usage-by-rank.png | Bin 0 -> 21318 bytes .../accessible-governments-world.png | Bin 0 -> 60415 bytes .../accessibility/accessible-governments.png | Bin 0 -> 34717 bytes .../accessibility/alt-attribute-lengths.png | Bin 0 -> 21802 bytes .../accessibility/button-name-sources.png | Bin 0 -> 27041 bytes ...olor-contrast-2019-2020-2021-2022-2024.png | Bin 0 -> 19716 bytes .../common-file-extensions-in-alt-text.png | Bin 0 -> 19679 bytes .../2024/accessibility/country-by-geoid.png | Bin 0 -> 46041 bytes .../accessibility/country-by-tld-globe.png | Bin 0 -> 60163 bytes .../2024/accessibility/country-by-tld.png | Bin 0 -> 60222 bytes .../2024/accessibility/font-unit-usage.png | Bin 0 -> 18260 bytes .../accessibility/form-input-name-sources.png | Bin 0 -> 27876 bytes .../accessibility/form-required-controls.png | Bin 0 -> 23076 bytes .../accessibility/javascript-frontend-ui.png | Bin 0 -> 32546 bytes .../javascript-meta-frameworks.png | Bin 0 -> 31833 bytes .../lighthouse-audit-markup-improvements.png | Bin 0 -> 29660 bytes .../lighthouse-audit-median-score-yoy.png | Bin 0 -> 21101 bytes .../microsoft-inclusivity-gudelines.png | Bin 0 -> 19869 bytes .../accessibility/page_title-information.png | Bin 0 -> 22050 bytes .../pages-overriding-focus-styles.png | Bin 0 -> 21426 bytes .../pages-using-a11y-apps-by-rank.png | Bin 0 -> 23591 bytes .../accessibility/pages-using-a11y-apps.png | Bin 0 -> 22350 bytes .../pages-with-element-role-yty.png | Bin 0 -> 18489 bytes .../pages-zooming-scaling-disabled.png | Bin 0 -> 22908 bytes .../placeholder-but-no-label.png | Bin 0 -> 22662 bytes .../2024/accessibility/platform-cms.png | Bin 0 -> 32931 bytes .../tabindex-usage-and-values.png | Bin 0 -> 20211 bytes .../2024/accessibility/top-10-aria-roles.png | Bin 0 -> 42942 bytes .../accessibility/top10-aria-attributes.png | Bin 0 -> 47240 bytes .../2024/accessibility/traditional-cms.png | Bin 0 -> 30494 bytes .../userpreference-media-queries.png | Bin 0 -> 27889 bytes src/tools/test/test_status_codes.js | 2 +- 38 files changed, 1175 insertions(+), 15 deletions(-) create mode 100644 src/static/images/2024/accessibility/US-state-governments-map.png create mode 100644 src/static/images/2024/accessibility/US-state-governments.png create mode 100644 src/static/images/2024/accessibility/a11y-app-usage-by-rank.png create mode 100644 src/static/images/2024/accessibility/accessible-governments-world.png create mode 100644 src/static/images/2024/accessibility/accessible-governments.png create mode 100644 src/static/images/2024/accessibility/alt-attribute-lengths.png create mode 100644 src/static/images/2024/accessibility/button-name-sources.png create mode 100644 src/static/images/2024/accessibility/color-contrast-2019-2020-2021-2022-2024.png create mode 100644 src/static/images/2024/accessibility/common-file-extensions-in-alt-text.png create mode 100644 src/static/images/2024/accessibility/country-by-geoid.png create mode 100644 src/static/images/2024/accessibility/country-by-tld-globe.png create mode 100644 src/static/images/2024/accessibility/country-by-tld.png create mode 100644 src/static/images/2024/accessibility/font-unit-usage.png create mode 100644 src/static/images/2024/accessibility/form-input-name-sources.png create mode 100644 src/static/images/2024/accessibility/form-required-controls.png create mode 100644 src/static/images/2024/accessibility/javascript-frontend-ui.png create mode 100644 src/static/images/2024/accessibility/javascript-meta-frameworks.png create mode 100644 src/static/images/2024/accessibility/lighthouse-audit-markup-improvements.png create mode 100644 src/static/images/2024/accessibility/lighthouse-audit-median-score-yoy.png create mode 100644 src/static/images/2024/accessibility/microsoft-inclusivity-gudelines.png create mode 100644 src/static/images/2024/accessibility/page_title-information.png create mode 100644 src/static/images/2024/accessibility/pages-overriding-focus-styles.png create mode 100644 src/static/images/2024/accessibility/pages-using-a11y-apps-by-rank.png create mode 100644 src/static/images/2024/accessibility/pages-using-a11y-apps.png create mode 100644 src/static/images/2024/accessibility/pages-with-element-role-yty.png create mode 100644 src/static/images/2024/accessibility/pages-zooming-scaling-disabled.png create mode 100644 src/static/images/2024/accessibility/placeholder-but-no-label.png create mode 100644 src/static/images/2024/accessibility/platform-cms.png create mode 100644 src/static/images/2024/accessibility/tabindex-usage-and-values.png create mode 100644 src/static/images/2024/accessibility/top-10-aria-roles.png create mode 100644 src/static/images/2024/accessibility/top10-aria-attributes.png create mode 100644 src/static/images/2024/accessibility/traditional-cms.png create mode 100644 src/static/images/2024/accessibility/userpreference-media-queries.png diff --git a/src/config/2024.json b/src/config/2024.json index 0d4659e1eda..a1abf227497 100644 --- a/src/config/2024.json +++ b/src/config/2024.json @@ -86,8 +86,7 @@ "part": "II", "chapter_number": "10", "title": "Accessibility", - "slug": "accessibility", - "todo": true + "slug": "accessibility" }, { "part": "II", diff --git a/src/config/contributors.json b/src/config/contributors.json index ec56a948c3d..291fb9526d0 100644 --- a/src/config/contributors.json +++ b/src/config/contributors.json @@ -571,6 +571,16 @@ "twitter": "LoukilAymen", "website": "http://www.aymen-loukil.com/en/" }, + "b_atish": { + "name": "Beatriz González Mellídez", + "teams": { + "2024": [ + "reviewers" + ] + }, + "twitter": "b_atish", + "website": "https://medium.com/@b_atish" + }, "tunetheweb": { "avatar_url": "10931297", "github": "tunetheweb", @@ -1638,6 +1648,18 @@ }, "twitter": "HenriHelvetica" }, + "hidde": { + "avatar_url": "178782", + "github": "hidde", + "name": "Hidde de Vries", + "teams": { + "2024": [ + "reviewers" + ] + }, + "mastodon": "@hdv@front-end.social", + "website": "https://hidde.blog/" + }, "housseindjirdeh": { "avatar_url": "12476932", "github": "housseindjirdeh", @@ -2022,6 +2044,29 @@ "twitter": "jtteag", "website": "https://gemservers.com" }, + "JonathanAvila": { + "avatar_url": "5640755", + "github": "mraccess77", + "name": "Jonathan Avila", + "linkedin": "jonathan-avila-cpwa-2a964a7", + "teams": { + "2024": [ + "editors" + ] + } + }, + "JonathanPagel": { + "avatar_url": "63317370", + "github": "jcmpagel", + "linkedin": "jonathan-pagel", + "name": "Jonathan Pagel", + "teams": { + "2024": [ + "editors" + ] + }, + "website": "https://jonathanpagel.com" + }, "sirjonathan": { "avatar_url": "104149", "github": "sirjonathan", @@ -2708,6 +2753,19 @@ ] } }, + "mgifford": { + "avatar_url": "116832", + "github": "mgifford", + "linkedin": "mgifford", + "mastodon": "https://mastodon.social/@mgifford", + "name": "Mike Gifford", + "teams": { + "2024": [ + "authors", + "analysts" + ] + } + }, "mikegeyser": { "avatar_url": "105242", "github": "mikegeyser", @@ -3620,6 +3678,9 @@ "designers", "editors", "reviewers" + ], + "2024": [ + "editors" ] } }, diff --git a/src/content/en/2024/accessibility.md b/src/content/en/2024/accessibility.md index 09a45973ede..50b59a61795 100644 --- a/src/content/en/2024/accessibility.md +++ b/src/content/en/2024/accessibility.md @@ -2,17 +2,1117 @@ #See https://github.com/HTTPArchive/almanac.httparchive.org/wiki/Authors'-Guide#metadata-to-add-at-the-top-of-your-chapters title: Accessibility description: Accessibility chapter of the 2024 Web Almanac covering ease of reading, navigation, forms, media, ARIA, and accessibility apps. -authors: [] -reviewers: [] -editors: [] -analysts: [] +authors: [mgifford] +reviewers: [hidde, b_atish] +analysts: [mgifford] +editors: [JonathanPagel, JonathanAvila, shantsis] translators: [] +discuss: results: https://docs.google.com/spreadsheets/d/1btB1r9QpdgTyToPhn7glcGAdMFs7eq4UcQSVIHBqiYQ/ -featured_quote: -featured_stat_1: -featured_stat_label_1: -featured_stat_2: -featured_stat_label_2: -featured_stat_3: -featured_stat_label_3: +mgifford_bio: Mike Gifford is CivicActions' Open Standards & Practices Lead. He is also a thought leader on open government, digital accessibility and sustainability. He has served as a Drupal Core Accessibility Maintainer and also a W3C Invited Expert. He is a recognized authoring tool accessibility expert and contributor to the W3C's Draft Web Sustainability Guidelines (WSG) 1.0. +featured_quote: Most modern governments have committed to either WCAG 2.0 AA or WCAG 2.1 AA. It is clear that the implementation of these policies isn't being equally delivered. +featured_stat_1: 40% +featured_stat_label_1: Of desktop sites and 39% of mobile sites have at least one `role="presentation"`. +featured_stat_2: 0.1% +featured_stat_label_2: Sites with `