aria-at-app icon indicating copy to clipboard operation
aria-at-app copied to clipboard

Reference files content-only change in aria-at#1173 not creating new version after test import

Open IsaDC opened this issue 10 months ago • 4 comments

Context:

PR #1173 resolved an issue that was blocking NVDA tests from running. However, the PR only updated the test example and not the corresponding test plan.

Issue:

Due to the test plan not being modified in PR #1173, it's currently impossible to update the test plan to a new version.

Question:

Is there a way to quickly push an update to the test plan to address this issue? CC @howard-e @jugglinmike Thanks!

Related PR: ARIA-AT #1173

IsaDC avatar Jan 22 '25 17:01 IsaDC

@IsaDC just to confirm, this is about https://github.com/w3c/aria-at/pull/1173? And not the linked aria-at-app's https://github.com/w3c/aria-at-app/issues/1173? As what was linked above points to an accessibility issue that doesn't impact tests from running.

howard-e avatar Jan 22 '25 21:01 howard-e

@IsaDC after properly checking out https://github.com/w3c/aria-at/pull/1173 instead like I was assuming, I'm now sure the issue is indeed there so no need to confirm!

A "quick" way this could be addressed is to rename the reference folders used in both tests/link-css/references/ and tests/link-img-alt/references/ then update the reference value cell in both tests/link-css/data/references.csv and tests/link-img-alt/data/references.csv.

The reason it didn't trigger a version bump as is, is because the contents of those files aren't being directly referenced on import, rather the files are being pointed to and rendered when needed.

I'm not well versed on the expectations around the frequency and need for those reference folder renames as I wasn't present when that was built. But it feels like this is a use case it should cover (a folder name update with content update -- even when not freshly imported). I'm only speculating on that though, so if there's a request to trigger a version bump with just an update to a references folder's content, we can also track that for the future!

howard-e avatar Jan 22 '25 21:01 howard-e

@IsaDC after properly checking out w3c/aria-at#1173 instead like I was assuming, I'm now sure the issue is indeed there so no need to confirm!

A "quick" way this could be addressed is to rename the reference folders used in both tests/link-css/references/ and tests/link-img-alt/references/ then update the reference value cell in both tests/link-css/data/references.csv and tests/link-img-alt/data/references.csv.

The reason it didn't trigger a version bump as is, is because the contents of those files aren't being directly referenced on import, rather the files are being pointed to and rendered when needed.

I'm not well versed on the expectations around the frequency and need for those reference folder renames as I wasn't present when that was built. But it feels like this is a use case it should cover (a folder name update with content update -- even when not freshly imported). I'm only speculating on that though, so if there's a request to trigger a version bump with just an update to a references folder's content, we can also track that for the future!

@IsaDC after properly checking out w3c/aria-at#1173 instead like I was assuming, I'm now sure the issue is indeed there so no need to confirm!

A "quick" way this could be addressed is to rename the reference folders used in both tests/link-css/references/ and tests/link-img-alt/references/ then update the reference value cell in both tests/link-css/data/references.csv and tests/link-img-alt/data/references.csv.

The reason it didn't trigger a version bump as is, is because the contents of those files aren't being directly referenced on import, rather the files are being pointed to and rendered when needed.

I'm not well versed on the expectations around the frequency and need for those reference folder renames as I wasn't present when that was built. But it feels like this is a use case it should cover (a folder name update with content update -- even when not freshly imported). I'm only speculating on that though, so if there's a request to trigger a version bump with just an update to a references folder's content, we can also track that for the future!

Thank you @howard-e! Would you mind pushing those changes to the test plan at your end? I focused on rebuilding the test plans with the existing examples, rather than pulling new ones, so I didn't think renaming the "references" folder was necessary in my PR.

IsaDC avatar Jan 23 '25 19:01 IsaDC

Discussed in 2025-01-23 CG Meeting today, test admins will move forward with a suitable rename which forces the the app to pick up the import.

The app team will investigate further how we can allow for these "reference content only" changes to be picked up and create a new import without any additional tweaks for the future.

sharing above to use this as the tracking issue

howard-e avatar Jan 23 '25 21:01 howard-e