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

Define roadmap for integration with WCAG-EM #4331

Open
mgifford opened this issue Jun 3, 2021 · 4 comments
Open

Define roadmap for integration with WCAG-EM #4331

mgifford opened this issue Jun 3, 2021 · 4 comments
Labels
feature request help wanted Extra attention is needed

Comments

@mgifford
Copy link

mgifford commented Jun 3, 2021

Is your feature request related to a problem? Please describe.

We need to have some clarity about we want to be able to use the Accessibility Insights reports in conjunction with something like a WCAG-EM tool.

Right now so many of these automated tools are used in a few different ways as people are evaluating websites. Defining a template for evaluating sites using Accessibility Insights & the WCAG-EM Report Generator would be brilliant.

Describe the desired outcome

I think it could look a little bit like this.

  1. Start a new report
  2. Define the scope
  3. Explore the Target Website
  4. Collect Sample URLs that either is a Structured Sample, a Randomly Selected Sample, or a Complete Processes
  5. Open link to defined pages and examine it with FastPass (axe & tab)
    • Run assessment (which would automatically include the elements from the axe scan
    • Save the assessment and upload it to the WCAG-EM page
    • Repeat for all Sample URLs defined
  6. Review the Report the Evaluation Findings
  7. Save the JSON version of the Website Accessibility Evaluation Report and if needed the HTML

The JSON report could then be sent to the developers who could either parse the material into Jira or Trello. Or they could simply:

  1. Import a the provided report
  2. Review the scope
  3. Review the Target Website
  4. Verify that the Sample URLs are valid.
    • Ensure that the problems can be replicated by the development team.
    • Prioritize list of tasks to address concerns
    • Complete accessibility fixes
  5. Open link to updated pages and examine it with FastPass (axe & tab)
    • Run assessment (which would automatically include the elements from the axe scan
    • Note changes which have been made and ideally point to pull requests or issue queues
    • Save the assessment and upload it to the WCAG-EM page
    • Repeat for all Sample URLs defined
  6. Review the Report the Evaluation Findings
  7. Save the JSON version of the Website Accessibility Evaluation Report and if needed the HTML
  8. Diff the version of the report that the team was provided with the version of the report after revisions were made.

This would really help to ensure that development teams are able to resolve issues with confidence.

@ghost ghost added the status: new This issue is new and requires triage by DRI. label Jun 3, 2021
@ghost ghost assigned karanbirsingh Jun 3, 2021
@karanbirsingh karanbirsingh added status: ready for triage This issue is ready to be triaged by the Accessibility Insights team. and removed status: new This issue is new and requires triage by DRI. labels Jun 3, 2021
@ghost ghost assigned ferBonnin Jun 3, 2021
@ghost
Copy link

ghost commented Jun 3, 2021

This issue has been marked as ready for team triage; we will triage it in our weekly review and update the issue. Thank you for contributing to Accessibility Insights!

@karanbirsingh karanbirsingh removed their assignment Jun 10, 2021
@ferBonnin
Copy link
Contributor

Thanks for the feature request @mgifford!
after talking with the team, we would be happy to take on a community contribution for this feature request for the particular request of a template and JSON report in the format of the WCAG -EM report generator.

@ferBonnin ferBonnin added help wanted Extra attention is needed and removed status: ready for triage This issue is ready to be triaged by the Accessibility Insights team. labels Jun 25, 2021
@mgifford
Copy link
Author

I'll re-open this if we get to developing that. In the interim though, thought I'd add a link to this related project https://github.com/GSA/open-product-accessibility-template

@mgifford
Copy link
Author

Just as an update, OPAT is now going by OpenACR. There's also an editor that is live here https://gsa.github.io/openacr-editor/

We would want to be able to import in the same way as WCAG-EM is doing with JSON-LC formatted EARL data.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
feature request help wanted Extra attention is needed
Projects
Status: Help wanted
Development

No branches or pull requests

3 participants