Skip to content

Commit

Permalink
Merge pull request #402 from w3c/move-content
Browse files Browse the repository at this point in the history
Move content directly into wai-website
  • Loading branch information
shawna-slh authored Apr 18, 2024
2 parents c766009 + 8fee2ab commit e82f246
Show file tree
Hide file tree
Showing 22 changed files with 1,521 additions and 49 deletions.
11 changes: 11 additions & 0 deletions .github/ISSUE_TEMPLATE/config.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
blank_issues_enabled: true
contact_links:
- name: Translations intents
url: https://github.com/w3c/wai-translations/issues/new/choose
about: Want to translate a WAI resource? Use this link to declare your intent.
- name: WCAG
url: https://github.com/w3c/wcag/issues/
about: WCAG discussions take place in the repository hosting WCAG data.
- name: WCAG-EM Report Tool
url: https://github.com/w3c/wai-wcag-em-report-tool/issues/new/choose
about: Issues concerning the WCAG-EM Report Tool should be reported using this link.
26 changes: 26 additions & 0 deletions .github/ISSUE_TEMPLATE/content-issue.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
name: "Content issue"
description: Report a problem with content on WAI website.
body:
- type: input
id: wai-url
attributes:
label: Resource URL
description: The link to the page this issue is about or, if it's about multiple pages, an example or most important page.
validations:
required: true
- type: textarea
id: description
attributes:
label: Add a description
validations:
required: true
- type: markdown
attributes:
value: |
---
The following field is prefilled and should not be modified. Please click "Submit new issue".
- type: input
id: wai-resource-id
attributes:
label: Resource Shortname
description: Set automatically. Do not modify.
14 changes: 14 additions & 0 deletions .github/labeler.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
customize-design:
- 'wai-customize-design'
shared-experiences:
- 'wai-shared-experiences'
intro-act:
- 'wai-intro-act'
intro-earl:
- 'wai-intro-earl'
combined-expertise:
- 'wai-combined-expertise'
inclusion:
- 'wai-inclusion'
wcag-mob-overlap:
- 'wai-wcag-mob-overlap'
19 changes: 19 additions & 0 deletions .github/workflows/label-issues.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
name: "Issue Labeler"
on:
issues:
types: [opened, edited, reopened]

permissions:
issues: write
contents: read

jobs:
triage:
runs-on: ubuntu-latest
steps:
- uses: github/[email protected]
with:
configuration-path: .github/labeler.yml
enable-versioned-regex: 0
sync-labels: 1
repo-token: ${{ github.token }}
30 changes: 1 addition & 29 deletions .gitmodules
Original file line number Diff line number Diff line change
@@ -1,11 +1,7 @@
[submodule "_external/data"]
path = _external/data
url = https://github.com/w3c/wai-website-data.git
branch = master
[submodule "_external/resources/wai-inclusion"]
path = _external/resources/wai-inclusion
url = https://github.com/w3c/wai-inclusion.git
branch = gh-pages
branch = update-terms-feedback-box
[submodule "_external/resources/wai-bcase"]
path = _external/resources/wai-bcase
url = https://github.com/w3c/wai-bcase.git
Expand Down Expand Up @@ -82,10 +78,6 @@
path = _external/resources/wai-eval-report-templates
url = https://github.com/w3c/wai-eval-report-templates.git
branch = master
[submodule "_external/resources/wai-combined-expertise"]
path = _external/resources/wai-combined-expertise
url = https://github.com/w3c/wai-combined-expertise.git
branch = master
[submodule "_external/resources/wai-InvolveUsersAll"]
path = _external/resources/wai-InvolveUsersAll
url = https://github.com/w3c/wai-InvolveUsersAll.git
Expand Down Expand Up @@ -118,10 +110,6 @@
path = _external/resources/wai-intro-wcag
url = https://github.com/w3c/wai-intro-wcag.git
branch = master
[submodule "_external/resources/wai-intro-earl"]
path = _external/resources/wai-intro-earl
url = https://github.com/w3c/wai-intro-earl.git
branch = master
[submodule "_external/resources/wai-intro-uaag"]
path = _external/resources/wai-intro-uaag
url = https://github.com/w3c/wai-intro-uaag.git
Expand All @@ -146,18 +134,6 @@
path = _external/resources/wai-about-wai
url = https://github.com/w3c/wai-about-wai.git
branch = master
[submodule "_external/resources/wai-wcag-mob-overlap"]
path = _external/resources/wai-wcag-mob-overlap
url = https://github.com/w3c/wai-wcag-mob-overlap.git
branch = master
[submodule "_external/resources/wai-shared-experiences"]
path = _external/resources/wai-shared-experiences
url = https://github.com/w3c/wai-shared-experiences.git
branch = master
[submodule "_external/resources/wai-customize-design"]
path = _external/resources/wai-customize-design
url = https://github.com/w3c/wai-customize-design.git
branch = master
[submodule "_external/resources/wai-sitemap"]
path = _external/resources/wai-sitemap
url = https://github.com/w3c/wai-sitemap.git
Expand All @@ -182,10 +158,6 @@
path = _external/resources/wai-eval-standards
url = https://github.com/w3c/wai-eval-standards.git
branch = master
[submodule "_external/resources/wai-intro-act"]
path = _external/resources/wai-intro-act
url = https://github.com/w3c/wai-intro-act.git
branch = master
[submodule "_external/resources/wai-video-standards-and-benefits"]
path = _external/resources/wai-video-standards-and-benefits
url = https://github.com/w3c/wai-video-standards-and-benefits.git
Expand Down
8 changes: 4 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# wai-website
# W3C WAI Website

Preview: https://wai-website.netlify.com/
WAI Website Manual: https://wai-website-theme.netlify.com/overview/
- Live Website: https://www.w3.org/WAI/
- Preview: https://wai-website.netlify.com/

[![Netlify Status](https://api.netlify.com/api/v1/badges/faaa4954-0194-47fa-9b74-540ab79f4a8d/deploy-status)](https://app.netlify.com/sites/wai-website/deploys) ![Create Downloadable Release](https://github.com/w3c/wai-website/workflows/Create%20Downloadable%20Release/badge.svg)
[![Netlify Status](https://api.netlify.com/api/v1/badges/faaa4954-0194-47fa-9b74-540ab79f4a8d/deploy-status)](https://app.netlify.com/sites/wai-website/deploys)
2 changes: 1 addition & 1 deletion _config.yml
Original file line number Diff line number Diff line change
Expand Up @@ -41,7 +41,7 @@ repository: w3c/wai-website
ytkey: AIzaSyCiZ9uToWu9jb7BTx47NtzCvmGGXKXp8nI

# remote_themes are an extension for Jekyll running in GitHub pages and are a GitHub repo
remote_theme: w3c/wai-website-theme
remote_theme: w3c/wai-website-theme@update-feedback-box

paginate: 5
paginate_path: "/news/:num/"
Expand Down
1 change: 0 additions & 1 deletion _external/resources/wai-combined-expertise
Submodule wai-combined-expertise deleted from ae1848
1 change: 0 additions & 1 deletion _external/resources/wai-customize-design
Submodule wai-customize-design deleted from 2df12e
1 change: 0 additions & 1 deletion _external/resources/wai-inclusion
Submodule wai-inclusion deleted from 6348fa
1 change: 0 additions & 1 deletion _external/resources/wai-intro-act
Submodule wai-intro-act deleted from c16e9b
1 change: 0 additions & 1 deletion _external/resources/wai-intro-earl
Submodule wai-intro-earl deleted from e26bd2
1 change: 0 additions & 1 deletion _external/resources/wai-shared-experiences
Submodule wai-shared-experiences deleted from bb4af3
1 change: 0 additions & 1 deletion _external/resources/wai-wcag-mob-overlap
Submodule wai-wcag-mob-overlap deleted from 14151b
1 change: 0 additions & 1 deletion _includes/read-this-first.html

This file was deleted.

1 change: 0 additions & 1 deletion pages/fundamentals/accessibility-usability-inclusion.md

This file was deleted.

114 changes: 114 additions & 0 deletions pages/fundamentals/accessibility-usability-inclusion.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,114 @@
---
title: Accessibility, Usability, and Inclusion
lang: en
github:
repository: remibetin/wai-website
path: 'pages/fundamentals/accessibility-usability-inclusion.md'
label: wai-inclusion
permalink: /fundamentals/accessibility-usability-inclusion/
layout: default
footer: >
<p><strong>Date:</strong> Updated 6 May 2016. First published March 2010.</p>
<p><strong>Editors:</strong> <a href="https://www.w3.org/People/Shawn/">Shawn Lawton Henry</a>, <a href="https://www.w3.org/People/shadi/">Shadi Abou-Zahra</a>, and <a href="https://www.w3.org/People/kevin">Kevin White</a>. Contributors: Sharron Rush, and <a href="https://www.w3.org/WAI/EO/EOWG-members">EOWG Participants</a>.</p>
<p>Developed by the Education and Outreach Working Group (<a href="http://www.w3.org/WAI/EO/">EOWG</a>). Previously developed with support of the <a href="/WAI/WAI-AGE/"><abbr>WAI-AGE</abbr> Project</a>.</p>
---

## Introduction
{:.no-display}

*Accessibility, usability, and inclusion* are closely related aspects in creating a web that works for everyone. Their goals, approaches, and guidelines overlap significantly. It is most effective to address them together when designing and developing websites and applications.

There are a few situations when it's important to focus specifically on one aspect. For example, when developing standards and policies. Researching the accessibility needs of people with disabilities helps with developing those.

This article briefly:

- explains the distinctions and overlaps between accessibility, usability, and inclusive design,
- encourages increased coordination across research and practice in these disciplines, and,
- points out the importance of maintaining the focus of accessibility on people with disabilities.

Distinctions and Overlaps {#terms}
-------------------------

**Accessibility**: addresses discriminatory aspects related to equivalent user experience for people with disabilities. Web accessibility means that people with disabilities can equally perceive, understand, navigate, and interact with websites and tools. It also means that they can contribute equally without barriers. For more information, see the [Accessibility introduction](/fundamentals/accessibility-intro/).

**Usability**: is about designing products to be effective, efficient, and satisfying. Usability includes *user experience design*. This may include general aspects that impact everyone and do not disproportionally impact people with disabilities. Usability practice and research often does not sufficiently address the needs of people with disabilities.

**Inclusion**: is about diversity, and ensuring involvement of everyone to the greatest extent possible. In some regions this is also referred to as *universal design* and *design for all*. It addresses a broad range of issues including:

* accessibility for people with disabilities;
* access to and quality of hardware, software, and Internet connectivity;
* computer literacy and skills;
* economic situation;
* education;
* geographic location;
* culture;
* age, including older and younger people;
* and language.

### Accessibility and Usability {#accessible-usable}

Accessibility primarily focuses on people with disabilities. Many accessibility requirements improve usability for everyone, especially in limiting situations. For example, providing sufficient contrast benefits people using the web on a mobile device in bright sunlight or in a dark room. Captions benefit people in noisy and in quiet environments. Some people have age-related functional limitations, and may not identify these as "disability". Accessibility addresses these situations too.

Accessibility includes:

- **Requirements that are technical and relate to the underlying code rather than to the visual appearance**. For example, they ensure that websites work well with assistive technologies. This includes screen readers that read aloud content, and screen magnifiers that enlarge content. Voice recognition software used to input text is another form of assistive technology. These aspects are typically not a focus of usability research and practice.
- **Requirements that relate to user interaction and visual design**. Inadequate design can cause significant barriers for people with disabilities. That is why they are included. For example, understandable instructions and feedback for website forms and applications is good usability. They also help people with cognitive and learning disabilities. Without such requirements, some people with disabilities may be excluded from using the Web.

There is a significant overlap between accessibility and usability. [ISO 9241-11 {% include_cached external.html %}](https://www.iso.org/iso/catalogue_detail.htm?csnumber=16883), defines usability as:

> The "extent to which a product can be used by specified users to achieve specified goals effectively, efficiently and with satisfaction in a specified context of use".
This could address accessibility ***when***:

* "specified users" includes people with a range of disabilities, and
* "specified context of use" includes accessibility considerations such as assistive technologies.

But usability practice and research often does not consider the needs of people with disabilities.

### Accessibility and Inclusion {#inclusive-design}

Several accessibility requirements also benefit people and situations that are a focus of inclusive design. For example, [Web Accessibility
Benefits People With and *Without* Disabilities](https://www.w3.org/WAI/bcase/soc#groups) describes accessibility benefits for:

- people with low literacy or not fluent in the language,
- people with low bandwidth connections or using older technologies,
- new and infrequent users, and,
- [mobile device users](/standards-guidelines/wcag-mobile-overlap/).

However, accessibility focuses on disability and does not try to address broader issues. Other efforts, such as [internationalization](https://www.w3.org/International/), address other inclusion issues. Keeping accessibility focused on disabilities encourages research and development on the specific needs of people with disabilities, and solutions that are optimized for these specific needs.

Accessible Design
-----------------

There are [guidelines, standards, and techniques for web accessibility](/standards-guidelines/), such as the Web Content Accessibility Guidelines ([WCAG](/standards-guidelines/wcag/), which is the international standard [ISO/IEC 40500](https://www.w3.org/blog/2012/10/wcag-20-is-now-also-isoiec-405/).
Yet when designers, developers, and project managers approach accessibility as a checklist to meet these standards, the focus is only on the technical aspects of accessibility. As a result, the human interaction aspect is often lost, and accessibility is not achieved.

Combining accessibility standards and usability processes with real people ensures that web design is technically and functionally usable by people with disabilities. This is referred to as *usable accessibility* or *accessible user experience (UX)*.

### Usable Accessibility

Web designers and developers can use usability processes, methods, and techniques, to address the user interface component of accessibility.
While the considerations of people with disabilities are not always included in common practices, they can be easily integrated into user experience design.

A key aspect is incorporating **real people** in design:

- Ensuring that everyone involved in web projects understands the basics of [how people with disabilities use the Web](/people-use-web/),
- [Involving users with disabilities](/planning/involving-users/) early and throughout the design process, and
- [Involving users in evaluating web accessibility](/test-evaluate/involving-users/).

**Accessibility standards** also have an important role in accessible design. For example, understanding the basic [Accessibility Principles](/fundamentals/accessibility-principles/) and using them for developing and evaluating early prototypes helps the development team provide basic accessibility in the earliest stages.
Addressing accessibility at later stages becomes increasingly difficult.

Also, usability processes and user involvement alone cannot address all accessibility issues. Even large projects cannot cover the diversity of disabilities, adaptive strategies, and assistive technologies.
Accessibility guidelines, standards, and techniques ensure that the wide range of issues are adequately covered.

Conclusion
----------

Accessibility practitioners and researchers can incorporate usability techniques to improve 'usable accessibility'. User experience designers and researchers can incorporate accessibility to make their designs work better for more people in more situations. Addressing accessibility, usability, and inclusion together can more effectively lead to a more accessible, usable, and inclusive web for everyone. Resources to help are linked throughout this page.

For more on this topic, see [The role of accessibility in a universal web {% include_cached external.html %}](https://dspace.mit.edu/handle/1721.1/88013), which:

- provides a more in-depth exploration of the importance and benefits of accessibility as a distinct discipline, and
- encourages increased communication and coordination between accessibility, usability, and inclusion research and practice.

1 change: 0 additions & 1 deletion pages/standards-guidelines/wai-intro-act.md

This file was deleted.

Loading

0 comments on commit e82f246

Please sign in to comment.