From 825f919cc2a27aee51c51354098a94b954d54ead Mon Sep 17 00:00:00 2001 From: Cam Race <52536248+cjrace@users.noreply.github.com> Date: Wed, 10 Jul 2024 09:19:25 +0100 Subject: [PATCH] Add accessibility resources page (#60) * add initial notes * update renv lock to r4.4.1 * Tidy up notes on accessibility tools page and add in links * fix broken link (issue 54) * fix navigation typo * response to PR comments (will squash commits on merge) * PR response 2 --- _quarto.yml | 1 + index.qmd | 2 + learning-development/accessibility.qmd | 80 ++++++++++++++++++++++++++ learning-development/sql.qmd | 2 +- renv.lock | 2 +- 5 files changed, 85 insertions(+), 2 deletions(-) create mode 100644 learning-development/accessibility.qmd diff --git a/_quarto.yml b/_quarto.yml index 589f868..4aa26fe 100644 --- a/_quarto.yml +++ b/_quarto.yml @@ -83,6 +83,7 @@ website: - learning-development/r.qmd - learning-development/git.qmd - learning-development/python.qmd + - learning-development/accessibility.qmd - section: "Statistics production" contents: - statistics-production/pub.qmd diff --git a/index.qmd b/index.qmd index ca78505..6c3fd52 100644 --- a/index.qmd +++ b/index.qmd @@ -34,6 +34,8 @@ We hope it can prove a useful community driven resource for everyone from the mo [Python](learning-development/python.html) - Guidance and tips for using Python +[Accessibility](learning-development/accessibility.html) +- Tools and resources for digital accessibility ## Statistics production diff --git a/learning-development/accessibility.qmd b/learning-development/accessibility.qmd new file mode 100644 index 0000000..0b382a4 --- /dev/null +++ b/learning-development/accessibility.qmd @@ -0,0 +1,80 @@ +--- +title: "Accessibility" +--- + +

Some quick links and tips for increasing awareness of accessibility in digital content

+ + +--- + +## Accessibility in DfE + +Everyone has a part to play in ensuring that the content and digital services the DfE provides to its customers and colleagues are accessible. Everyone should have an understanding of their responsibilities to comply with the [Public Sector Bodies Accessibility Regulations 2018](https://www.legislation.gov.uk/uksi/2018/952/contents/made) and the [Web Content Accessibility Guidelines 2.2](https://www.w3.org/TR/WCAG22/). Moreover, everyone should also understand the important and critical difference this makes to the everyday lives of millions of people. + +DfE have our own [Digital Accessibility Hub](https://educationgovuk.sharepoint.com/sites/lvewp00043) filled with helpful information on making the digital world more accessible. + +There are also the [DfE design manual](https://design.education.gov.uk), which has been created by the digital teams at DfE and includes [DfE's digital accessibility guidance](https://design.education.gov.uk/accessibility). + + +If you want to estimate or try to appreciate just how many people might have specific needs, there is the [How many people? tool](https://design.education.gov.uk/tools/how-many-users), simply enter how many people your audience is, and it will give you best estimates of how many people might have a disability, impairment or other characteristics which might affect how they use your service. + +--- + +## Colour accessibility tools + +Contrast: + +- [WebAim (comparing two colours)](https://webaim.org/resources/contrastchecker/) +- [Colour contrast matrix (comparing multiple colours](https://jansensan.github.io/color-contrast-matrix/) + +Colour blindness: + +- [Adobe colour accessibility (gives a pass / fail)](https://color.adobe.com/create/color-accessibility/) +- [Coblis (simulates colour blindness for uploaded images)](https://www.color-blindness.com/coblis-color-blindness-simulator/) +- [ColourBlindCheck (R package for simulating colour blindness for a colour palette)](https://github.com/Nowosad/colorblindcheck) + +Grey scale: + +- You can often check colours in grey scale by using a print preview and switching the colour mode +- [ColToGrey function within the DescTools R package](https://andrisignorell.github.io/DescTools/reference/ColToGrey.html) + +For more advice about colour in charts and visualisations specifically, including more tools and resources for checking colours yourself, see the [Analysis function colours in charts guidance](https://analysisfunction.civilservice.gov.uk/policy-store/data-visualisation-colours-in-charts/#section-9). + +--- + +## Free tools for reviewing web pages + +- [axe DevTools](https://chromewebstore.google.com/detail/axe-devtools-web-accessib/lhdoppojpmngadmnindnejefpokejbdd?pli=1), free Google Chrome extension and paid versions, we recommend this (and Government Digital Service tend to recommend too) + +- [Google Lighthouse](https://developer.chrome.com/docs/lighthouse/overview), built into Google Chrome browser, and will catch some basic accessibility things amongst other web related issues + +'Bookmarklets' are bookmarks that instead of saving a URL to a page, save a piece of Javascript code that executes on the page you are looking at. There's some nice [accessibility focused bookmarklets](https://design.education.gov.uk/accessibility/assurance) that highlight specific types of mark up such as headers and lists so you can easily check if it matches what you'd expect while on any webpage. Very nifty and low effort too! + +--- + +## Assistive technology + +No automated tools fully cover accessibility, manual testing is always required, so if you want to do manual testing have a look at testing out the assistive software commonly used by users yourself. + +Magnifiers / advanced zoom: + +- Windows Magnifier, comes as standard with Windows ([guidance for how to turn on Magnifier](https://support.microsoft.com/en-gb/windows/use-magnifier-to-make-things-on-the-screen-easier-to-see-414948ba-8b1c-d3bd-8615-0e5e32204198#:~:text=To%20quickly%20turn%20on%20Magnifier,turn%20on%20the%20Magnifier%20switch.)) +- [ZoomText](https://www.freedomscientific.com/products/software/zoomtext/), available through the [experience lab in DfE](https://educationgovuk.sharepoint.com/sites/lvewp00043/SitePages/Experience-Lab.aspx) + +Screen reader: + +- [Non-visual Desktop Access (NVDA) free download](https://www.nvaccess.org/download/) +- [Job Access With Speech (JAWS)](https://www.freedomscientific.com/products/software/jaws/), available through the [experience lab in DfE](https://educationgovuk.sharepoint.com/sites/lvewp00043/SitePages/Experience-Lab.aspx) + +Voice activation: + +- [Dragon](https://www.nuance.com/en-gb/dragon.html), available through the [experience lab in DfE](https://educationgovuk.sharepoint.com/sites/lvewp00043/SitePages/Experience-Lab.aspx) + + +Cognitive load: + +- While there isn't commonly used specific assistive technology for aiding users in reducing cognitive load, you can take many steps to reduce the cognitive load for users on your service, making it simpler to use for all. Have a read of [Cognitive Load as a Guide: 12 Spectrums to Improve Your Data Visualisations](https://nightingaledvs.com/cognitive-load-as-a-guide-12-spectrums-to-improve-your-data-visualizations/) as a starting point if you want to learn more. + +Along with devices and the software mentioned above, the [experience lab in the Sheffield DfE office](https://educationgovuk.sharepoint.com/sites/lvewp00043/SitePages/Experience-Lab.aspx) also has a range of other equipment available, including access to a set of vision emulating glasses that you can wear to emulate different visual impairments. + +--- \ No newline at end of file diff --git a/learning-development/sql.qmd b/learning-development/sql.qmd index 7932a19..e977a49 100644 --- a/learning-development/sql.qmd +++ b/learning-development/sql.qmd @@ -42,7 +42,7 @@ Andy Brook's excellent Introduction to SQL session, giving a visual overview of ## Best practice -Here are some tips to follow best practice in your SQL code, making it easier to read and pick up if another person is running your code. Following best practice guidance will help you to achieve RAP best practice with [clean final code](../RAP/rap.html#Clean_final_code) +Here are some tips to follow best practice in your SQL code, making it easier to read and pick up if another person is running your code. Following best practice guidance will help you to achieve RAP best practice with [clean final code](../RAP/rap-statistics.html#clean-final-code). * Avoid any trailing whitespace * Always capitalize SQL keywords (e.g., SELECT or AS) diff --git a/renv.lock b/renv.lock index c9de68f..fbb1565 100644 --- a/renv.lock +++ b/renv.lock @@ -1,6 +1,6 @@ { "R": { - "Version": "4.3.3", + "Version": "4.4.1", "Repositories": [ { "Name": "CRAN",