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

Document differences between information that can be provided for a VPAT & an OpenACR #271

Open
mgifford opened this issue Jan 10, 2022 · 4 comments
Assignees
Labels
documentation Improvements or additions to documentation website Related to the general website

Comments

@mgifford
Copy link
Collaborator

mgifford commented Jan 10, 2022

There are a number of slight optional variations so it is worth while to explain these more fully.

It is useful to have a comparison between ACR so that it is easy to see what is being added to OpenACR.

@mgifford mgifford added documentation Improvements or additions to documentation website Related to the general website labels Jan 10, 2022
@farooqzakhilwal farooqzakhilwal added this to the Option 2 - Sprint 2 milestone Feb 1, 2022
@melindaburgess
Copy link

@mgifford What do you think about a page under "Guide" that is "VPAT vs OpenACR"?

Could explain high level differences, and then dive deeper into those optional variations. It could also be where we point people from that link on the home page that says "Is this just a VPAT?"

Here's a doc where you can write down those differences, if you wish: https://docs.google.com/document/d/1vXAE2PukWn7eL_IoYjWbL9OqDkGfd3F6qdjUGm1UWSk/edit

@mgifford
Copy link
Collaborator Author

mgifford commented Feb 18, 2022

Differences

VPAT OpenACR
Instructions at the top of the document Instructions inline in the application
Need to delete instructions Instructions stay on OpenACR Editor
Not consistently structured Highly structured with validation
No dashboard/summary Live summary of completion of report
No built-in accessibility Built in accessible HTML
No version control Versioning by date & auto-increment
Manual progress tracking Automated progress tracking and validation
Just one contact Breaking out Author & Vendor contacts
No default license Default to open license, but options for other
No mention of where the document lives Including repository link in form
No feedback cycle Opportunity for link for feedback to author
Need to manually delete tables Ability to hide tables
Limited by 8.5x11 table No limits in length
All content in tables ability to jump from report to editor
Not machine readable Machine readable YAML
No standard date format Standard date format
No guidance on multi-software projects Ability to include related ACRs
No built-in security Built in security evaluations in editor
Usually exported as PDF Native HTML support

@danid123
Copy link

Benefits of OpenACR: Progress tracking and validation. Not sure what the VPAT side would be for this.

Version control is on there twice.

@mgifford
Copy link
Collaborator Author

@danid123 version control is important!

Seriously though, I guess you could do some sort of version control through Word...

I'll edit the table above with these great suggestions.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation website Related to the general website
Projects
None yet
Development

No branches or pull requests

4 participants