Skip to content
This repository was archived by the owner on Mar 14, 2024. It is now read-only.

Conversation

@brendankenny
Copy link
Contributor

Adds a Lighthouse accessibility docs section and migrates the last of the content from web.dev (the rest of the accessibility audits were redirected to axe docs in GoogleChrome/web.dev#8654).

  • all the audit articles only had a change to the layout and updated links where needed
  • scoring/index.md - I regenerated the accessibility weight table because it was super out of date. I don't know if there's a ton of value in seeing the audit weights (we don't have a similar page for best practices/SEO, for instance), but there are ~1500 visitors a month, so we can just keep the page.

@netlify
Copy link

netlify bot commented Sep 19, 2022

Deploy Preview for developer-chrome-com ready!

Name Link
🔨 Latest commit fcf9e80
🔍 Latest deploy log https://app.netlify.com/sites/developer-chrome-com/deploys/6329fe142a3b1d0009a704a1
😎 Deploy Preview https://deploy-preview-3768--developer-chrome-com.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 settings.

@chrome-devrel-review-bot
Copy link
Collaborator

chrome-devrel-review-bot commented Sep 19, 2022

Hello! This is an automated review by our custom reviewbot. It updates automatically when code or GitHub comments in this pull request are created or updated.

Requested changes

If there are any common problems with the content files you created or modified, they will be listed here.

site/en/docs/lighthouse/accessibility/custom-control-roles/index.md

  • Please change your usage of the following words:
    • Do not use master. Affected lines: 76

site/en/docs/lighthouse/accessibility/custom-controls-labels/index.md

  • Please change your usage of the following words:
    • Do not use master. Affected lines: 55

site/en/docs/lighthouse/accessibility/focus-traps/index.md

  • Please change your usage of the following words:
    • Do not use master. Affected lines: 55

site/en/docs/lighthouse/accessibility/focusable-controls/index.md

  • Please change your usage of the following words:
    • Do not use master. Affected lines: 78

site/en/docs/lighthouse/accessibility/index.md

  • This file passed all of our automated Markdown audits.

site/en/docs/lighthouse/accessibility/interactive-element-affordance/index.md

  • Please change your usage of the following words:
    • Do not use master. Affected lines: 61

site/en/docs/lighthouse/accessibility/logical-tab-order/index.md

  • Please change your usage of the following words:
    • Do not use master. Affected lines: 60

site/en/docs/lighthouse/accessibility/managed-focus/index.md

  • Please change your usage of the following words:
    • Do not use master. Affected lines: 77

site/en/docs/lighthouse/accessibility/offscreen-content-hidden/index.md

  • Please change your usage of the following words:
    • Do not use master. Affected lines: 55

site/en/docs/lighthouse/accessibility/scoring/index.md

  • This file passed all of our automated Markdown audits.

site/en/docs/lighthouse/accessibility/use-landmarks/index.md

  • Please change your usage of the following words:
    • Do not use master. Affected lines: 78

site/en/docs/lighthouse/accessibility/visual-order-follows-dom/index.md

  • Please change your usage of the following words:
    • Do not use master. Affected lines: 54

@@ -1,13 +1,16 @@
- url: /docs/lighthouse/overview/
- url: /docs/lighthouse/seo/
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

rearranged this so that the TOC is in the same order as the Lighthouse report (perf, a11y, best practices, seo, pwa)

Comment on lines 52 to 56
{% Glitch {
id: 'gorgeous-raven',
path: 'example.html:13:39',
height: 346
} %}
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

unfortunately several of these rely on a hosted form of chromevox-lite (in this example at https://robdodson.github.io/chromevox-lite/dist/index.min.mjs) which doesn't exist in that repo anymore and doesn't seem to be hosted elsewhere now. If we can't find a replacement, I guess we'll just delete?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I suppose if that's what we need to do until we can find an interim solution. Is there a way to comment out nunjucks syntax? Perhaps it could be fixed later.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I suppose if that's what we need to do until we can find an interim solution. Is there a way to comment out nunjucks syntax? Perhaps it could be fixed later.

Commented it out and left an short explanation.

I was wrong and the other glitches are actually fine, it's just this one, so it's not a huge deal if we can't get a replacement.

---
layout: 'layouts/project-landing.njk'
title: 'Accessibility Audits'
description: 'These checks highlight opportunities to improve the accessibility of your web app. Only a subset of accessibility issues can be automatically detected so manual testing is also encouraged.'
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

since the TOC is already generated per locale, it would be nice if this could use i18n.docs.lighthouse-accessibility.overview so you wouldn't need an index.md per locale

Copy link
Member

@malchata malchata left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursory look, but LGTM

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants