From 8534f2dab29c2d9bf81769047c45dfb06d3965ca Mon Sep 17 00:00:00 2001 From: Ben Ford Date: Wed, 9 Apr 2025 11:07:58 -0700 Subject: [PATCH 1/4] Adds a basic VPAT document See https://en.wikipedia.org/wiki/Voluntary_Product_Accessibility_Template for information about the VPAT standard. This describes the accessibility features of OpenVox. It does -NOT- add it to the navigation menu at this time, so the URL will need to be shared directly with users who require it. We can figure out later how we want to display or link to this. The link will be http://voxpupuli.org/openvox/vpat/ --- openvox/vpat.md | 74 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 74 insertions(+) create mode 100644 openvox/vpat.md diff --git a/openvox/vpat.md b/openvox/vpat.md new file mode 100644 index 0000000..da48fba --- /dev/null +++ b/openvox/vpat.md @@ -0,0 +1,74 @@ +--- +layout: page +title: Voluntary Product Accessibility Template +subsection: openvox +--- + +The Voluntary Product Accessibility Template (VPAT) is a document that describes how an information technology (IT) product, such as software, hardware, or web-based applications, meets the accessibility standards defined by Section 508 of the Rehabilitation Act. This VPAT describes the accessibility features of the OpenVox open-source project. + +* Product Name: OpenVox +* Version: (all versions) + +## Evaluation Methods Used + +This VPAT is based on a review of the OpenVox tool and project documentation, including the project website and the software documentation. +It also references upstream documentation from the [puppet.com](https://www.puppet.com/docs/puppet/latest) website. + +### Section 1194.21 - Software Applications and Operating Systems + +OpenVox is a command-line utility for configuring, automating, and managing computer infrastructure. +It is designed as a server-agent model, driven by a plain-text codebase. +This means that once installed and configured, most users' interactions will be via writing or editing code in their text editor of choice. +Users with accessibility needs may configure their editors with the assistive technologies they rely on. + +Administering, configuring, or using the software generally involves editing files on the filesystem and executing commands. +Like other command-line tools, this software can be used with screen readers and other assistive technologies to access the command-line interface to perform these operations. +The OpenVox software interface itself is not optimized for use with assistive technologies. +Users with accessibility needs may configure their command line terminal and editors with the assistive technologies they rely on. + +### Section 1194.22 - Web-based Intranet and Internet Information and Applications + +OpenVox does not have any web-based features, so this section does not apply. + +### Section 1194.23 - Telecommunications Products + +OpenVox does not include any telecommunications features, so this section does not apply. + +### Section 1194.24 - Video and Multimedia Products + +OpenVox does not include any video or multimedia features, so this section does not apply. + +### Section 1194.25 - Self-Contained, Closed Products + +OpenVox is an open-source command-line utility and does not meet the requirements of this section. + +### Section 1194.26 - Desktop and Portable Computers + +OpenVox is a command-line utility and does not include a graphical user interface (GUI) that could be used with assistive technologies. This section does not apply. + +### Section 1194.31 - Functional Performance Criteria + +OpenVox does not include any functional performance criteria. + +### Section 1194.41 - Information, Documentation, and Support + +The OpenVox project provides built-in documentation in the form of Unix man pages and help function output. +This documentation is accessible using screen readers and other assistive technologies. +The Vox Pupuli project publishes online documentation in HTML format, which is accessible using screen readers and other assistive technologies. +The documentation includes installation instructions, tutorials, best-practice guides, and other resources. +However, this documentation is not designed with accessibility needs in mind and may be difficult to read with some screen readers and other assistive technologies. +The project does not offer any support services for users with disabilities. + +As the OpenVox project is a fork of the formerly open source Puppet project, users often also refer to the upstream Puppet documentation. +This upstream documentation includes installation and configurations instructions, conceptual guides, language references, and other resources. +However, this upstream documentation is not designed with accessibility needs in mind and relies on Javascript in the browser for basic functionality. +This may make it difficult to read or navigate with some screen readers and other assistive technologies. + +Like most technical documentation, OpenVox and Puppet documentation may be technical and difficult for non-technical users to understand. + +## Conclusion + +OpenVox is an open-source command-line utility that provides basic accessibility features for users who rely on assistive technologies. +However, the software is not optimized for use with assistive technologies and may require significant customization to be accessible to all users. +Users with accessibility needs may configure their command line terminal and editors with the assistive technologies they rely on. +The project provides accessible online documentation, but may not be suitable for non-technical users. From e6a0e4d557797a7c45587c7d5f53471775bb87e8 Mon Sep 17 00:00:00 2001 From: Ben Ford Date: Wed, 9 Apr 2025 13:18:45 -0700 Subject: [PATCH 2/4] add TUI --- openvox/vpat.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/openvox/vpat.md b/openvox/vpat.md index da48fba..b4be9dc 100644 --- a/openvox/vpat.md +++ b/openvox/vpat.md @@ -44,7 +44,7 @@ OpenVox is an open-source command-line utility and does not meet the requirement ### Section 1194.26 - Desktop and Portable Computers -OpenVox is a command-line utility and does not include a graphical user interface (GUI) that could be used with assistive technologies. This section does not apply. +OpenVox is a command-line utility and does not include a graphical user interface (GUI or TUI) that could be used with assistive technologies. This section does not apply. ### Section 1194.31 - Functional Performance Criteria From 7492fd0d058228f0852ae392c623a90274a009c4 Mon Sep 17 00:00:00 2001 From: Ben Ford Date: Thu, 10 Apr 2025 10:40:57 -0700 Subject: [PATCH 3/4] Update openvox/vpat.md Co-authored-by: Ewoud Kohl van Wijngaarden --- openvox/vpat.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/openvox/vpat.md b/openvox/vpat.md index b4be9dc..645c614 100644 --- a/openvox/vpat.md +++ b/openvox/vpat.md @@ -4,7 +4,8 @@ title: Voluntary Product Accessibility Template subsection: openvox --- -The Voluntary Product Accessibility Template (VPAT) is a document that describes how an information technology (IT) product, such as software, hardware, or web-based applications, meets the accessibility standards defined by Section 508 of the Rehabilitation Act. This VPAT describes the accessibility features of the OpenVox open-source project. +The Voluntary Product Accessibility Template (VPAT) is a document that describes how an information technology (IT) product, such as software, hardware, or web-based applications, meets the accessibility standards defined by Section 508 of the Rehabilitation Act. +This VPAT describes the accessibility features of the OpenVox open-source project. * Product Name: OpenVox * Version: (all versions) From 2a6ded950ef761aa1da298f020f65ba245f31f01 Mon Sep 17 00:00:00 2001 From: Ben Ford Date: Thu, 10 Apr 2025 10:42:16 -0700 Subject: [PATCH 4/4] Update openvox/vpat.md --- openvox/vpat.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/openvox/vpat.md b/openvox/vpat.md index 645c614..6367c8e 100644 --- a/openvox/vpat.md +++ b/openvox/vpat.md @@ -4,7 +4,7 @@ title: Voluntary Product Accessibility Template subsection: openvox --- -The Voluntary Product Accessibility Template (VPAT) is a document that describes how an information technology (IT) product, such as software, hardware, or web-based applications, meets the accessibility standards defined by Section 508 of the Rehabilitation Act. +The Voluntary Product Accessibility Template (VPAT) is a document that describes how an information technology (IT) product, such as software, hardware, or web-based applications, meets the accessibility standards defined by Section 508 of the US Rehabilitation Act. This VPAT describes the accessibility features of the OpenVox open-source project. * Product Name: OpenVox