openacr
openacr copied to clipboard
GSA
Document differences between information that can be provided for a VPAT & an OpenACR
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 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
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 |
Benefits of OpenACR: Progress tracking and validation. Not sure what the VPAT side would be for this.
Version control is on there twice.
@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.