Skip to content

Remove dead Plain Language resource URL causing HTMLProofer failure#894

Open
Copilot wants to merge 2 commits into
mainfrom
copilot/fix-html-proofer-failure
Open

Remove dead Plain Language resource URL causing HTMLProofer failure#894
Copilot wants to merge 2 commits into
mainfrom
copilot/fix-html-proofer-failure

Conversation

Copilot AI commented Jun 8, 2026

Copy link
Copy Markdown

One-line summary

Remove the stale Plain Language Association International link that now returns 404 and breaks the scheduled Checking links workflow.

Description

The Building site and running HTML proofer job failed because one external URL in site content became invalid. This change removes only that broken link from the Plain Language guide resources list to restore link-check stability without relaxing checks.

  • Failure source
    • HTMLProofer reported a 404 for https://plainlanguagenetwork.org/plain-language/what-is-plain-language/.
  • Applied fix
    • Removed that single resource entry from _guide/plain-language.md.
  • Code snippet
    ## Resources
    
    * [Federal Plain Language guidelines](https://www.plainlanguage.gov/guidelines/)
    * [WCAG 2.1 Reading level success criterion](https://www.w3.org/WAI/WCAG21/Understanding/reading-level.html)

Types of Changes

What types of changes does your code introduce? Keep the ones that apply:

  • Bug fix (non-breaking change which fixes an issue)
  • Documentation / non-code

Tasks

List of tasks you will do to complete the PR

  • Identify the exact failing URL from Actions logs (job 80073713142)
  • Remove the broken external link from content
  • Keep workflow/checker configuration unchanged

Review

List of tasks the reviewer must do to review the PR

  • Tests
  • Documentation
  • CHANGELOG

Deployment Notes

None.

@dmundra

dmundra commented Jun 8, 2026

Copy link
Copy Markdown
Contributor

Tugboat has finished building the preview for this pull request!

Link:

Dashboard:

Copilot AI changed the title [WIP] Fix failing GitHub Actions job for HTML proofer Remove dead Plain Language resource URL causing HTMLProofer failure Jun 8, 2026
Copilot AI requested a review from dmundra June 8, 2026 14:17
@dmundra dmundra requested a review from mgifford June 8, 2026 14:19
@dmundra dmundra marked this pull request as ready for review June 8, 2026 14:19
@github-actions

github-actions Bot commented Jun 8, 2026

Copy link
Copy Markdown
Pa11y testing results
> pa11y-ci:sitemap
> pa11y-ci --sitemap http://127.0.0.1:4000/sitemap.xml --sitemap-find https://accessibility.civicactions.com --sitemap-replace http://127.0.0.1:4000 --sitemap-exclude "/*.pdf"

Running Pa11y on 133 URLs:
 > http://localhost:4000/guide/champions-program - 0 errors
 > http://localhost:4000/guide/defect-priority - 0 errors
 > http://localhost:4000/guide/design - 0 errors
 > http://localhost:4000/guide/documents - 0 errors
 > http://localhost:4000/guide/events - 0 errors
 > http://localhost:4000/guide/glossary - 0 errors
 > http://localhost:4000/guide/history - 0 errors
 > http://localhost:4000/guide/identity-language - 0 errors
 > http://localhost:4000/guide/introduction - 0 errors
 > http://localhost:4000/guide/onboarding-staff - 0 errors
 > http://localhost:4000/guide/organizations - 0 errors
 > http://localhost:4000/guide/plain-language - 0 errors
 > http://localhost:4000/guide/resources - 0 errors
 > http://localhost:4000/guide/semantic-html - 0 errors
 > http://localhost:4000/guide/social-media - 0 errors
 > http://localhost:4000/guide/tools - 0 errors
 > http://localhost:4000/guide/training - 0 errors
 > http://localhost:4000/about/people/allison-carroll - 0 errors
 > http://localhost:4000/about/people/civicactions - 0 errors
 > http://localhost:4000/about/people/daniel-mundra - 0 errors
 > http://localhost:4000/about/people/jack-haas - 0 errors
 > http://localhost:4000/about/people/jennifer-houde - 0 errors
 > http://localhost:4000/about/people/jonathan-bourland - 0 errors
 > http://localhost:4000/about/people/luke-fretwell - 0 errors
 > http://localhost:4000/about/people/michelle-kang - 0 errors
 > http://localhost:4000/about/people/mike-gifford - 0 errors
 > http://localhost:4000/about/people/nira-datta - 0 errors
 > http://localhost:4000/about/people/vanessa-luxen - 0 errors
 > http://localhost:4000/personas/accessibility-avery - 0 errors
 > http://localhost:4000/personas/designer-darcy - 0 errors
 > http://localhost:4000/personas/engineer-emery - 0 errors
 > http://localhost:4000/personas/procurement-parker - 0 errors
 > http://localhost:4000/personas/qa-quincy - 0 errors
 > http://localhost:4000/personas/remote-raz - 0 errors
 > http://localhost:4000/playbook/AT - 0 errors
 > http://localhost:4000/playbook/ai-and-ia - 0 errors
 > http://localhost:4000/playbook/authoring - 0 errors
 > http://localhost:4000/playbook/automated-testing - 0 errors
 > http://localhost:4000/playbook/checklists - 0 errors
 > http://localhost:4000/playbook/community - 0 errors
 > http://localhost:4000/playbook/distributed-teams - 0 errors
 > http://localhost:4000/playbook/documents - 0 errors
 > http://localhost:4000/playbook/follow-global-initiatives - 0 errors
 > http://localhost:4000/playbook/manual-testing - 0 errors
 > http://localhost:4000/playbook/personalization - 0 errors
 > http://localhost:4000/playbook/practice - 0 errors
 > http://localhost:4000/playbook/pwd - 0 errors
 > http://localhost:4000/playbook/roles - 0 errors
 > http://localhost:4000/playbook/statements - 0 errors
 > http://localhost:4000/playbook/training - 0 errors
 > http://localhost:4000/posts/4-ways-to-improve-government-accessibility-through-open-source - 0 errors
 > http://localhost:4000/posts/hello-world - 0 errors
 > http://localhost:4000/posts/whitehouse.gov-beginning-an-accessibility-journey - 0 errors
 > http://localhost:4000/posts/gcn-accessibility-compliance-as-code - 0 errors
 > http://localhost:4000/posts/improve-government-accessibility-through-open-source - 0 errors
 > http://localhost:4000/posts/govtech-how-will-biden-transform-government-website-accessibility - 0 errors
 > http://localhost:4000/posts/automated-accessibility-testing-leveraging-github-actions-and-pa11y-ci-with-axe - 0 errors
 > http://localhost:4000/posts/government-accessibility-and-the-cms-problem - 0 errors
 > http://localhost:4000/posts/at-banter-podcast - 0 errors
 > http://localhost:4000/posts/mvp-playbook - 0 errors
 > http://localhost:4000/posts/mvp-guide - 0 errors
 > http://localhost:4000/posts/smashingmag-baking-in-accessibility-testing - 0 errors
 > http://localhost:4000/posts/qa-with-mike-gifford-accessibility-in-civic-tech - 0 errors
 > http://localhost:4000/posts/launching-a-community-of-practice-for-accessibility-in-government-services - 0 errors
 > http://localhost:4000/posts/pre-GAAD-Authoring-Tools-Built-in-Accessibility - 0 errors
 > http://localhost:4000/posts/website-analytics - 0 errors
 > http://localhost:4000/posts/how-we-scale-inclusive-website-content-with-automated-testing-and-open-source-tools - 0 errors
 > http://localhost:4000/posts/social-media-accessibility-guide - 0 errors
 > http://localhost:4000/posts/plain-language-accessibility-guide - 0 errors
 > http://localhost:4000/posts/heart-accessibility - 0 errors
 > http://localhost:4000/posts/scanning-over-two-million-gov-pages - 0 errors
 > http://localhost:4000/posts/gsa-machine-readable-acr - 0 errors
 > http://localhost:4000/posts/CivicActions-Creates-Open-Product-Accessibility-Template - 0 errors
 > http://localhost:4000/posts/how-drupal-helps-us-bake-accessibility-into-every-project - 0 errors
 > http://localhost:4000/posts/CivicActions-Accessibility-Pledge - 0 errors
 > http://localhost:4000/posts/Talking-Drupal-Podcast - 0 errors
 > http://localhost:4000/posts/Talking-Drupal-Podcast-382 - 0 errors
 > http://localhost:4000/posts/governments-accessibility-opensource - 0 errors
 > http://localhost:4000/posts/FOSDEM-ccessibility-OpenSource - 0 errors
 > http://localhost:4000/posts/opensource-automated-accessibility-testing - 0 errors
 > http://localhost:4000/posts/helping-disabled-veterans-check-in-designing-an-accessibility-map - 0 errors
 > http://localhost:4000/posts/daniel-mundra-diving-into-drupal - 0 errors
 > http://localhost:4000/posts/how-omb-can-improve-gov-accessibility - 0 errors
 > http://localhost:4000/posts/fix-accessibility-bugs - 0 errors
 > http://localhost:4000/posts/five-reasons-to-get-excited-about-governmentwide-section-508-assessment-criteria - 0 errors
 > http://localhost:4000/posts/how-we-helped-a-government-website-achieve-zero-accessibility-errors - 0 errors
 > http://localhost:4000/posts/measuring-the-impact-of-manual-accessibility-testing - 0 errors
 > http://localhost:4000/posts/delivering-digital-first-turning-21st-century-idea-into-action - 0 errors
 > http://localhost:4000/posts/prioritizing-accessibility-bugs-for-maximum-impact - 0 errors
 > http://localhost:4000/projects/drupal - 0 errors
 > http://localhost:4000/projects/uswds-color - 0 errors
 > http://localhost:4000/projects/uswds - 0 errors
 > http://localhost:4000/roles/designer - 0 errors
 > http://localhost:4000/roles/developer - 0 errors
 > http://localhost:4000/roles/executive - 0 errors
 > http://localhost:4000/roles/operations - 0 errors
 > http://localhost:4000/roles/procurement - 0 errors
 > http://localhost:4000/roles/product-manager - 0 errors
 > http://localhost:4000/roles/project-manager - 0 errors
 > http://localhost:4000/topics/design - 0 errors
 > http://localhost:4000/topics/disability-type - 0 errors
 > http://localhost:4000/topics/process-policies - 0 errors
 > http://localhost:4000/topics/roles - 0 errors
 > http://localhost:4000/topics/testing - 0 errors
 > http://localhost:4000/topics/tools - 0 errors
 > http://localhost:4000/ACR/Drupal9AccessibilityConformanceReport.html - 0 errors
 > http://localhost:4000/ACR/ - 0 errors
 > http://localhost:4000/about/ - 0 errors
 > http://localhost:4000/accessibility - 0 errors
 > http://localhost:4000/agile - 0 errors
 > http://localhost:4000/analytics - 0 errors
 > http://localhost:4000/calendar - 0 errors
 > http://localhost:4000/colophon - 0 errors
 > http://localhost:4000/about/contact - 0 errors
 > http://localhost:4000/documentation - 0 errors
 > http://localhost:4000/guide/ - 0 errors
 > http://localhost:4000/heart - 0 errors
 > http://localhost:4000/help - 0 errors
 > http://localhost:4000/ - 0 errors
 > http://localhost:4000/news/ - 0 errors
 > http://localhost:4000/about/join - 0 errors
 > http://localhost:4000/license - 0 errors
 > http://localhost:4000/okrs - 0 errors
 > http://localhost:4000/open - 0 errors
 > http://localhost:4000/about/people/ - 0 errors
 > http://localhost:4000/personas/ - 0 errors
 > http://localhost:4000/playbook/ - 0 errors
 > http://localhost:4000/projects/ - 0 errors
 > http://localhost:4000/roles/ - 0 errors
 > http://localhost:4000/search - 0 errors
 > http://localhost:4000/services - 0 errors
 > http://localhost:4000/topics/ - 0 errors
 > http://localhost:4000/ACR/Drupal9AccessibilityConformanceReport-December2020.html - 0 errors

✔ 133/133 URLs passed

@dmundra dmundra left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

I am fine with removing the link. @mgifford what do you think? The site seems to be dead

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants