Skip to content

Commit

Permalink
Merge pull request codelikeagirlau#30 from codelikeagirlau/feature-br…
Browse files Browse the repository at this point in the history
…anch-20

Feature branch 20 - manifesto & pledge
  • Loading branch information
lulen11 authored Oct 25, 2023
2 parents 5259050 + 16418a6 commit 8813813
Show file tree
Hide file tree
Showing 3 changed files with 161 additions and 17 deletions.
33 changes: 16 additions & 17 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,14 +15,17 @@ Currently this repo is a mess of notes and links... help us make it better!
- [Other notes and incomplete thoughts](#other-notes-and-incomplete-thoughts)

## What is accessibility?

**[`^ back to top ^`](#accessibility-resources)**

On the web, accessibility ensures that users with disabilities are able to use all facets of a website. The World Wide Web Consortium (W3C) defines accessibility standards and guidelines that all website designers and developers should comply with.

Accessibility is often pooled together with other web standards like performance, usability and security at the end of developing a web project though our aim is to make it a priority throughout all stages of web development.

## Accessibility things to consider when creating web and digital products:

**[`^ back to top ^`](#accessibility-resources)**

- POUR principles: Perceivable, operable, understandable, robust
- HTML: use sematic elements (nav, section, article, aside, footer, header, etc) instead of divs - to assist with screen readers
- Video captions
Expand All @@ -37,7 +40,9 @@ Accessibility is often pooled together with other web standards like performance
- Building websites for slow internet connections, with technologies e.g Lazy Load, optimized images, fallback, SWR etc

## Tools and Resources:

**[`^ back to top ^`](#accessibility-resources)**

- [W3C Markup Validation Service](https://validator.w3.org/): This validator checks the markup validity of Web documents in HTML, XHTML, SMIL, MathML, etc.
- [Who Can Use](https://www.whocanuse.com/)
- [Digital NSW Colour Contrast resource](https://www.digital.nsw.gov.au/delivery/accessibility-and-inclusivity-toolkit/inclusive-design/colour-contrast)
Expand All @@ -59,6 +64,7 @@ Accessibility is often pooled together with other web standards like performance
- [Quick accessibility tests](https://youtu.be/ahDuaWKSGZA?si=QCTquw10i9R3h-MT) (YouTube playlist)

### Assistive technology

**[`^ back to top ^`](#accessibility-resources)**

Manual accessibility testing using assistive technology is a key part of ensuring your website is accessible.
Expand Down Expand Up @@ -123,25 +129,20 @@ Manual accessibility testing using assistive technology is a key part of ensurin
- [Endless Thread episode about how reddit failed it's blind moderators](https://www.wbur.org/endlessthread/2023/06/28/reddit-api-blind)

## Questions for digital teams and organisations to ask:

**[`^ back to top ^`](#accessibility-resources)**

- What would an accessibility-first process for digital products look like?
- What would an accessibility pledge look like?
- How can digital teams bake accessibility into their process?
- How does an organisation prioritise accecessibility?

## Who in an org should be responsible for accessibilitiy?
**[`^ back to top ^`](#accessibility-resources)**
- Designers:
- Content Writers:
- Devs and techies:
- QA and testers:
- Accessibility committees:
- EVERYONE!

## Assistive technology in action

**[`^ back to top ^`](#accessibility-resources)**

- [Kristy Viers uses voiceover and braille keyboard on the iphone](https://www.youtube.com/watch?v=wueLXCbm_KY)
- [Kristy Viers uses voiceover and braille keyboard on the ipad]( https://www.youtube.com/watch?v=vpQEQU3ExA0\ )
- [Kristy Viers uses voiceover and braille keyboard on the ipad](<https://www.youtube.com/watch?v=vpQEQU3ExA0\ >)
- [Jared Smith on his difficulties accessing the web as a blind user](https://youtu.be/yx7hdQqf8lE)
- [How Jared uses a sip and puff to control his computer](https://www.youtube.com/watch?v=Bhj5vs9P5cw)
- [Rakesh Babu's experiences as a blind user](https://youtu.be/qL4shFJHOvc)
Expand All @@ -155,6 +156,7 @@ Manual accessibility testing using assistive technology is a key part of ensurin
- [Endless Thread episode about how reddit failed it's blind moderators](https://www.wbur.org/endlessthread/2023/06/28/reddit-api-blind)

## People to Follow in Web Accessibility

Below is a list of individuals who are strong advocates for Accessibility and Inclusivity in the digital world. Some of the names on this list draw inspiration from the repo of [@Joe Watkins](https://github.com/joe-watkins/top-people-to-follow-in-web-accessibility).
| Name | Twitter |
| --- | --- |
Expand Down Expand Up @@ -222,7 +224,7 @@ Below is a list of individuals who are strong advocates for Accessibility and In
| Jennison Asuncion | [@Jennison](https://twitter.com/Jennison) |
| JoAnna Hunt | [@johunt0311](https://twitter.com/johunt0311) |
| Joe Dolson | [@joedolson](https://twitter.com/joedolson) |
| Joe Watkins | [@_josephwatkins](https://twitter.com/_josephwatkins) |
| Joe Watkins | [@\_josephwatkins](https://twitter.com/_josephwatkins) |
| John Foliot | [@johnfoliot](https://twitter.com/johnfoliot) |
| John McNabb | [@JohnKMcNabb](https://twitter.com/JohnKMcNabb) |
| Jonathan Hassell | [@jonhassell](https://twitter.com/jonhassell) |
Expand Down Expand Up @@ -277,16 +279,13 @@ Below is a list of individuals who are strong advocates for Accessibility and In
| Ted Drake | [@ted_drake](https://twitter.com/ted_drake) |

## Other notes and incomplete thoughts

**[`^ back to top ^`](#accessibility-resources)**

- Accessibility on Instagram - how does Instagram incorporate accessibility?
- The Roboto font - apparently this font is accessibility friendly, was it designed with this in mind?
- Other fonts that are dyslexia friendly
- [Person sues Coles for poor accessibility](https://www.business-humanrights.org/en/latest-news/australia-customer-sues-coles-supermarkets-over-alleged-disability-discrimination-re-accessibility-of-website/)
- "Digital" isn't just about web - how do we consider accessibility in webinars and online events, emails, audio, etc
- Sometimes the robot is good - can we use AI tools ethically for accessibility,e g. Otter AI for transcripts and meeting summaries, ChatGPT for digesting information and reducing overwhelm etc
- Autoplay of music and video - MySpace songs. Context is key. TikTok "mute on entry" setting.
- Dark patterns e.g. cannot unsubscribe to service.
- How do we consider people who aren't as tech savvy in how we set up our websites / apps/ digital products?
- [Helping blind people learn to code](https://www.freecodecamp.org/news/helping-blind-people-learn-to-code-c47c68d4a237/)
- Accessibility workshops?
- An accessibility-first website project would be a great portfolio piece (e.g. for someone looking for an internship)
- An accessibility-first website project would be a great portfolio piece (e.g. for someone looking for an internship)
104 changes: 104 additions & 0 deletions manifesto.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,104 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<meta http-equiv="X-UA-Compatible" content="ie=edge" />
<link rel="stylesheet" type="text/css" href="styles.css" />
<link
href="https://fonts.googleapis.com/css2?family=Gabarito:wght@400;500;600&family=Inter:wght@400;500;700&display=swap"
rel="stylesheet"
/>
<title>Accessibility Resources</title>
</head>
<body>
<main>
<h1>Accessibility Manifesto: Making the web better for everyone</h1>
<!-- the manifesto is a place for our big-picture, lofty thinking about accessibility. Values, ethics, etc. -->
<h2>What are we talking about when we talk about accessibility?</h2>
<ul>
<li>
We subscribe to the POUR principles: perceivable, operable,
understandable, robust
</li>
<li>
We are not bound or limited by common understandings of what
accessibilty includes. We want to make the web better for everyone,
whatever that involves.
</li>
<li>
"Digital" isn't just about web - how do we consider accessibility in
webinars and online events, emails, audio, etc
</li>
<li>
How do we consider people who aren't as tech savvy in how we set up
our websites / apps/ digital products?
</li>
<li>
Not using dark patterns (e.g. burying "unsubscribe" to service
options).
</li>
</ul>
<h2>
Who in an organisation is responsible, accountable, consulted and
informed when it comes to accessibility?
</h2>

<h3>Responsible</h3>
<ul>
<li>Designers</li>
<li>Content Writers</li>
<li>Devs and techies</li>
<li>QA and testers</li>
</ul>

<h3>Accountable</h3>

We suggest organisations form an "accessibiliy committee".

<h3>Consulted</h3>

<ul>
<li>Clients</li>
</ul>

<h3>Informed</h3>
<ul>
<li>Executives / board members</li>
<li>External stakeholders where relevant (e.g. grant reporting)</li>
</ul>
<h2>Ethical Considerations</h2>
<li>
Making websites and digital experiences accessibile is an ethical
imperative. While it is a legal requirement in some legislations and
contexts, we shouldn't let the legal requirements drive our work towards
accessibility.
</li>
<li>
Use of AI (sometimes the robot is good). How can we ensure we are using
AI tools ethically, e.g. Otter AI for transcripts and meeting summaries,
ChatGPT for digesting information and reducing overwhelm etc. What are
the ethical concerns with these technologies, and how can we mitigate
them?
</li>
<h2>Context is key</h2>
<ul>
<li>
Autoplay of music and video - MySpace songs. Context is key. TikTok
"mute on entry" setting.
</li>
</ul>
<h2>We need to challenge our preconceptions</h2>
<ul>
<li>
How can we go above and beyond what we thought possible - e.g.
<a
href="https://www.freecodecamp.org/news/helping-blind-people-learn-to-code-c47c68d4a237"
target="_blank"
>Helping blind people learn to code</a
>
</li>
</ul>
</main>
</body>
</html>
41 changes: 41 additions & 0 deletions web-developer-pledge.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<meta http-equiv="X-UA-Compatible" content="ie=edge" />
<link rel="stylesheet" type="text/css" href="styles.css" />
<link
href="https://fonts.googleapis.com/css2?family=Gabarito:wght@400;500;600&family=Inter:wght@400;500;700&display=swap"
rel="stylesheet"
/>
<title>Accessibility Resources</title>
</head>
<body>
<main>
<h1>Web Developer Accessibility Pledge</h1>
<p>As a web developer, I pledge to:</p>
<ul>
<li>
Check that my websites meet the Web Content Accessibility Guidelines
using the [WCAG Reference](https://www.w3.org/WAI/WCAG21/quickref/)
</li>
<li>Test my websites thorougly using assistive technologies</li>
<!-- To do - link to assistive technologies page/ section of this site -->
<li>
Commit to the continuous improvement of accessibility for websites
under my care
</li>
<li>
Stay up to date with the latest accessibility requirements from the
World Wide Web Consortium
</li>
<li>
Bake accessibilty into every phase of my web development projects
</li>
<!-- To do - link to development phases / checklist -->
<li>Advocate for accessibility with my clients, peers and colleages</li>
</ul>
</main>
</body>
</html>

0 comments on commit 8813813

Please sign in to comment.