the-turing-way icon indicating copy to clipboard operation
the-turing-way copied to clipboard

First draft of ACCESSIBILITY.md

Open aleesteele opened this issue 2 years ago • 5 comments

Summary

Fixes #3145

This draft is incomplete. It has information as it relates to accessibility across different aspects of the project (and how we as a community would like to promote accessibility!), and builds upon @AndreaSanchezTapia and @LizHareDogs as originally drafted for the upcoming guide for accessibility alongside @malvikasharan and others (documented in #2730 & #2942) and @AlexandraAAJ's draft about accessibility for events, as well as the translation & localisation's teams understanding of accessibility as a socio-linguistic question.

List of changes proposed in this PR (pull-request)

What should a reviewer concentrate their feedback on?

Acknowledging contributors

aleesteele avatar May 25 '23 21:05 aleesteele

Deploy Preview for the-turing-way ready!

Name Link
Latest commit e29331edc3bd0bf4e6803c8671c7cc333934a8e3
Latest deploy log https://app.netlify.com/sites/the-turing-way/deploys/64a4448de0589a000827793c
Deploy Preview https://deploy-preview-3146--the-turing-way.netlify.app
Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

netlify[bot] avatar May 25 '23 21:05 netlify[bot]

Deploy Preview for the-turing-way ready!

Name Link
Latest commit 8d3ee7227d41df87084c9624e7b901275f6b8665
Latest deploy log https://app.netlify.com/sites/the-turing-way/deploys/66015f73b5a185000877e6bb
Deploy Preview https://deploy-preview-3146--the-turing-way.netlify.app
Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

netlify[bot] avatar Oct 27 '23 13:10 netlify[bot]

Looks like the CI fails:

/home/runner/work/the-turing-way/the-turing-way/book/website/community-handbook/accessibility.md: WARNING: document isn't included in any toctree

Solution: The accessibility.md file needs to be added to the book/website/_toc.yml file.

kallewesterling avatar Nov 15 '23 11:11 kallewesterling

The edits to the policy document make it much clearer-- thank you all!

LizHareDogs avatar Nov 15 '23 21:11 LizHareDogs

Connecting this to #3427, where practices from the TTW Community Handbook are being documented.

In the Accessibility Working Group (@the-turing-way/accessibility-working-group), we have separated the Accessibility Policy (ACCESSIBILITY.md) from the other documentation efforts within the project:

  1. Accessibility Policy/ACCESSIBILITY.md: defining the standards that we hold ourselves to in the TTW community
  2. Community Handbook: Documenting what practices we currently do within the community to enable broader access
  3. Accessibility Guide: Creating a general guide for access-related practices that may or may not be currently used within the community (tied to #3307)

So they're all connected, but can be written at different speeds. I'm working on the Community Handbook documentation, as it enables me to add what we're doing right now, perhaps as opposed to or preparing for what we would like to do in the future.

aleesteele avatar Feb 20 '24 14:02 aleesteele

Closing this - and fixing this branch!

aleesteele avatar Mar 25 '24 11:03 aleesteele

@RichardJActon - we are pulling over your edits to this updated pull request, thank you! #3581

aleesteele avatar Dec 04 '24 16:12 aleesteele