Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Address single page view format issues #944

Merged
merged 11 commits into from
Mar 6, 2024
Merged

Address single page view format issues #944

merged 11 commits into from
Mar 6, 2024

Conversation

Paul-Clue
Copy link
Collaborator

see issue #745

This PR addresses the second set formatting issues brought up in issue #745.

Copy link
Contributor

@howard-e howard-e left a comment

Choose a reason for hiding this comment

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

@Paul-Clue looks good and happy you're so close to finishing off this bit of work!

There is something key missing, which is with handling assertionExceptions for the rendered commands tables.

Copy link
Contributor

@howard-e howard-e left a comment

Choose a reason for hiding this comment

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

@Paul-Clue LGTM! Thanks for addressing my feedback

Copy link
Contributor

@howard-e howard-e left a comment

Choose a reason for hiding this comment

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

@Paul-Clue apologies, looking back at the feedback of #745 (comment).

These items have not been fully addressed:

  • Under the heading "About This Test Plan", the title of the latest commit is not a link; it should be a link just like it is on the test plan version history page. Editorial note: I think it would be better if that list item had content: "Latest commit: title of latest commit.
  • There is an information architecture problem that does not appear to be covered by the original specification. The tests are under an H2 of "Supporting Documentation" instead of under the H2 "Tests". The "Supporting Documentation" heading should be moved before the ""Tests" heading. The resulting H2 order would then be: "About This Test Plan", "Supporting Documentation", "Tests". Then, each individual test will be an H3 under the H2 of "Tests".

@ccanash ccanash requested a review from alflennik March 5, 2024 18:08
Copy link
Contributor

@alflennik alflennik left a comment

Choose a reason for hiding this comment

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

Hi @Paul-Clue looks great, I was able to verify it working and successfully tested tons of test plans, on both the data management section as well as the candidate review section. I just have one possible issue and a couple of quick comments.

let shouldCount = 0;
let mayCount = 0;

let assertions = [...renderableContent.assertions];
Copy link
Contributor

Choose a reason for hiding this comment

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

I noticed in the alert example the should assertions were coming before the must assertions, which makes me think that sorting this array might be needed.

Screenshot 2024-03-05 at 5 05 33 PM

if (
settingsScreenText === null ||
settingsScreenText === ''
) {
Copy link
Contributor

Choose a reason for hiding this comment

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

Both of these values are falsy so this could be if (!settingsScreenText) { or even more compact:

const settingsScreenTextFormatted = settingsScreenText ? ` (${settingsScreenText})` : ''

@alflennik alflennik merged commit c81fb85 into main Mar 6, 2024
2 checks passed
@alflennik alflennik deleted the single-page-view-2 branch March 6, 2024 14:41
@mcking65
Copy link

mcking65 commented Mar 6, 2024

@Paul-Clue @howard-e @ccanash

Looking much better!! Thank you!!

I see one important problem looking at the page for alert in staging:

Captions on the table of assertions under each command heading are incorrect for NVDA and VoiceOver. For example, the caption on the spacebar command for voiceOver says:

Space (virtual cursor active): 1 MUST, 1 SHOULD, 0 MAY Assertions

It seems the caption is coming from the first AT, which is JAWS.

@mcking65
Copy link

mcking65 commented Mar 6, 2024

In the toggle button plan, there is no caption on the table for the first command for each screen reader.

Of less concern, in a v1 plan, like menu button, the captions say "Results for COMMAND_NAME" instead of following the caption format based on prior heading like it should.

@howard-e
Copy link
Contributor

howard-e commented Mar 6, 2024

@mcking65 great that the checks are generally going well! #948 was submitted to address the table caption bugs. It has now been reviewed, merged and pushed to staging.

@mcking65
Copy link

mcking65 commented Mar 6, 2024

Tested in staging. All resolved. Beautiful work. Thank you!

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.

4 participants