Skip to content

Conversation

kfranqueiro
Copy link
Contributor

This adds a workflow that will fail on the following:

  • Presence of video files
  • Presence of HTML files under techniques that don't follow the capital-abbreviation-then-number convention (which PRs tend to not follow until ready to merge, so they can sync then pick the correct number in the sequence)
  • Presence of class="instructions" paragraphs (this is a sign that template content in a new Technique or Understanding page hasn't been fully replaced)
  • Changes to legacy files that continue to exist in the repo, but that we avoid modifying
  • Changes to both guidelines and other content in the same PR (since we typically want to separate changes that generate errata)

I have performed extensive testing on my fork. Here are examples:

I have intentionally made this run as a single job so that it adds only 1 line to checks rather than 5 (since Netlify already adds 4 itself). I could foresee us adding even more checks in the future as well, and I really wouldn't want the Checks list to grow that long.

Example of what the check will look like:

Screenshot of Checks section of a GitHub PR, with the heading "Some checks were unsuccessful" and a single line item for "Check PR files / Check files (pull_request)" indicating a failure.

Example of what annotations look like upon failure:

Screenshot of a failed check's Annotations section, showing one error due to the process completing with exit code 1, followed by 2 notices, one for each specific test that failed.

The annotations can be found by expanding the "Annotations" section at the top of the job view (which is what clicking the failure in the PR's Checks section will navigate to), or at the bottom of the check's Summary view.

(Note: Within the job's logs, only the "Reflect status" job will actually show an error icon, because the previous steps can't actually cause errors or else it will exit early. And the alternative to that would be spawning 5 separate checks instead of 1, which would then crowd the Checks section in the PR itself.)

@kfranqueiro kfranqueiro requested a review from iadawn June 11, 2025 13:51
Copy link

netlify bot commented Jun 11, 2025

Deploy Preview for wcag2 ready!

Name Link
🔨 Latest commit 2d7b021
🔍 Latest deploy log https://app.netlify.com/projects/wcag2/deploys/684989eafed24f0008d6f949
😎 Deploy Preview https://deploy-preview-4438--wcag2.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 project configuration.

Copy link

netlify bot commented Jun 11, 2025

Deploy Preview for wcag2 ready!

Name Link
🔨 Latest commit 8bfca1f
🔍 Latest deploy log https://app.netlify.com/projects/wcag2/deploys/68498a0bbf535500085416f2
😎 Deploy Preview https://deploy-preview-4438--wcag2.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 project configuration.

@kfranqueiro kfranqueiro merged commit dc09af6 into w3c:main Jun 13, 2025
6 checks passed
@kfranqueiro kfranqueiro deleted the kgf-pr-checks branch June 13, 2025 17:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants