Skip to content

Commit

Permalink
finger-wagging a bit more
Browse files Browse the repository at this point in the history
  • Loading branch information
Bruce Lawson committed Oct 2, 2023
1 parent 51561da commit 7ad1dac
Show file tree
Hide file tree
Showing 3 changed files with 8 additions and 2 deletions.
5 changes: 4 additions & 1 deletion _site/standards/web-accessibility/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -85,7 +85,7 @@ <h1 class="hero hero--standards"><span class="layout">Web accessibility</span></
<li>Reading level</li>
</ul>
<p>Primarily, write semantic HTML. Without this rock solid base for your content, any later efforts to bolt on accessibility will fall short. Developers must familiarise themselves with the <a href="https://html.spec.whatwg.org/multipage/">HTML living standard</a> so that they use the best element for each piece of structure, content, and interaction.</p>
<p>All Barnardo's web pages must achieve <a href="https://www.w3.org/TR/WCAG21/">WCAG</a> (web content accessibility guidelines) AA conformance throughout, and level AAA conformance where possible. Restated, <strong>AA is a minimum, not a goal</strong>.</p>
<p>All Barnardo's web pages must achieve <a href="https://www.w3.org/TR/WCAG21/">WCAG</a> (web content accessibility guidelines) AA conformance throughout, and level AAA conformance where possible. Restated: <strong>AA conformance is a minimum, not a goal</strong>.</p>
<p>All text content must have a Flesch-Kincaid Grade Level of 4.2 or lower. To see the Flesch-Kincaid Grade Level in Word <a href="https://support.microsoft.com/en-us/office/get-your-document-s-readability-and-level-statistics-85b4969e-e80a-4777-8dd3-f7fc3c8b3fd2">follow these steps</a>.</p>
<p>Automated accessibility tools can pick up some problems, but manual testing is required to meet many success criteria. For example an automated tool cannot check if alternative text is descriptive and relevant.</p>
<p>Product owners must never allow the use of accessibility overlays. The people who use Barnardo's products deserve better, and any product that carries the Barnardo's name must provide better.</p>
Expand Down Expand Up @@ -146,6 +146,9 @@ <h2 class="section-navigation-title">Also in Standards</h2>
<div class="layout">
<aside>
<details><summary>Changelog</summary><ul><li>
<time datetime="2023-10-02">2023-00-02</time>: tweaked wording
<a href="https://github.com/barnardos/platforms-and-standards/commit/51561dac2618472f4d582ba3b265e4c7012f6f9c">51561da</a>
</li><li>
<time datetime="2023-10-02">2023-00-02</time>: absolute URL
<a href="https://github.com/barnardos/platforms-and-standards/commit/cca8a6fd0913b348915501068d8decf33feb7444">cca8a6f</a>
</li><li>
Expand Down
3 changes: 3 additions & 0 deletions _site/standards/web-performance/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -232,6 +232,9 @@ <h2 class="section-navigation-title">Also in Standards</h2>
<div class="layout">
<aside>
<details><summary>Changelog</summary><ul><li>
<time datetime="2023-10-02">2023-00-02</time>: tweaked wording
<a href="https://github.com/barnardos/platforms-and-standards/commit/51561dac2618472f4d582ba3b265e4c7012f6f9c">51561da</a>
</li><li>
<time datetime="2023-10-02">2023-00-02</time>: note on perf; tota11y test
<a href="https://github.com/barnardos/platforms-and-standards/commit/703edadf759e1ab79cb5b96dbf6227e2487cb798">703edad</a>
</li><li>
Expand Down
2 changes: 1 addition & 1 deletion standards/accessibility.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ It is a legal and moral obligation to make web content and functionality availab

Primarily, write semantic HTML. Without this rock solid base for your content, any later efforts to bolt on accessibility will fall short. Developers must familiarise themselves with the [HTML living standard](https://html.spec.whatwg.org/multipage/) so that they use the best element for each piece of structure, content, and interaction.

All Barnardo's web pages must achieve [WCAG](https://www.w3.org/TR/WCAG21/) (web content accessibility guidelines) AA conformance throughout, and level AAA conformance where possible. Restated, <strong>AA is a minimum, not a goal</strong>.
All Barnardo's web pages must achieve [WCAG](https://www.w3.org/TR/WCAG21/) (web content accessibility guidelines) AA conformance throughout, and level AAA conformance where possible. Restated: <strong>AA conformance is a minimum, not a goal</strong>.

All text content must have a Flesch-Kincaid Grade Level of 4.2 or lower. To see the Flesch-Kincaid Grade Level in Word [follow these steps](https://support.microsoft.com/en-us/office/get-your-document-s-readability-and-level-statistics-85b4969e-e80a-4777-8dd3-f7fc3c8b3fd2).

Expand Down

0 comments on commit 7ad1dac

Please sign in to comment.