From 889c923a2ec09d48f8599c58ee045181406aea8b Mon Sep 17 00:00:00 2001 From: Michael Harp Date: Wed, 12 Aug 2026 10:54:47 -0400 Subject: [PATCH] Fix breadcrumb markup and language issues from content review Markup: the product layout's breadcrumb closed a span with , producing invalid markup on every product page. Language: brand casing in the Why OpenVox breadcrumb, OpenBolt naming in the Ansible comparison table, a stray comma on get-support, VPAT wording (sections 1194.25 and 1194.31 now correctly say the sections do not apply rather than reading as compliance failures; Javascript -> JavaScript), and open-source -> open source per the Google style guide the docs follow. The sponsor-logo empty alts on get-support were reviewed and kept: the seven linked cards already carry the company name as link text, so W3C guidance says the logos are decorative (alt=""). Adding alt text made screen readers announce each card name twice. The --ignore-empty-alt flag in test.yml is now commented to record that this is deliberate. Partially addresses #14. Co-Authored-By: Claude Fable 5 Signed-off-by: Michael Harp --- .github/workflows/test.yml | 3 +++ _layouts/product.html | 2 +- get-support.html | 2 +- openvox-vs-ansible.html | 2 +- vpat.html | 14 +++++++++----- what-is-openvox.html | 2 +- why-openvox.html | 2 +- 7 files changed, 17 insertions(+), 10 deletions(-) diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml index 9594b74..cf85b16 100644 --- a/.github/workflows/test.yml +++ b/.github/workflows/test.yml @@ -51,4 +51,7 @@ jobs: # Images/Scripts verify built asset paths exist, so a stale Vite # manifest fails here instead of shipping broken pages. - name: Check internal links and assets + # --ignore-empty-alt is deliberate: the sponsor-card logos on + # get-support sit inside links that already carry the company name + # as text, so per W3C guidance the images are decorative (alt=""). run: bundle exec htmlproofer _site --disable-external --no-enforce-https --ignore-empty-alt --checks Links,Images,Scripts diff --git a/_layouts/product.html b/_layouts/product.html index dae36d1..717a279 100644 --- a/_layouts/product.html +++ b/_layouts/product.html @@ -4,7 +4,7 @@ Home Products - {{ page.name }} + {{ page.name }} diff --git a/get-support.html b/get-support.html index b8fa040..e52570b 100644 --- a/get-support.html +++ b/get-support.html @@ -11,7 +11,7 @@

Vox Pupuli is an open source community group and offers no commercial support of its - own. For free, peer support, join the community on + own. For free peer support, join the community on Slack or see the other channels at voxpupuli.org/connect. diff --git a/openvox-vs-ansible.html b/openvox-vs-ansible.html index 298cd20..fb7a905 100644 --- a/openvox-vs-ansible.html +++ b/openvox-vs-ansible.html @@ -51,7 +51,7 @@

At a glance

Target requirements - Agent installed (or agentless via Bolt) + Agent installed (or agentless via OpenBolt) SSH access and Python, no agent required diff --git a/vpat.html b/vpat.html index 8e8472a..3cdb400 100644 --- a/vpat.html +++ b/vpat.html @@ -22,7 +22,7 @@

Voluntary Product Accessibility Template

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. + the OpenVox open source project.

    @@ -68,7 +68,7 @@

    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.

    +

    OpenVox is an open source command-line utility, not a self-contained, closed product, so this section does not apply.

    Section 1194.26 — Desktop and Portable Computers

    @@ -78,7 +78,11 @@

    Section 1194.26 — Desktop and Portable Computers

    Section 1194.31 — Functional Performance Criteria

    -

    OpenVox does not include any functional performance criteria.

    +

    + As a command-line tool, OpenVox supports the functional performance criteria + through the assistive technologies available in the user's terminal and editor + environment, as described in Section 1194.21 above. +

    Section 1194.41 — Information, Documentation, and Support

    @@ -97,7 +101,7 @@

    Section 1194.41 — Information, Documentation, and Support

    often also refer to the upstream Puppet documentation. This upstream documentation includes installation and configuration 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 + 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.

    @@ -108,7 +112,7 @@

    Section 1194.41 — Information, Documentation, and Support

    Conclusion

    - OpenVox is an open-source command-line utility that provides basic accessibility + 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 diff --git a/what-is-openvox.html b/what-is-openvox.html index 46c03a8..ed633a5 100644 --- a/what-is-openvox.html +++ b/what-is-openvox.html @@ -55,7 +55,7 @@

    From Puppet to OpenVox

    configuration management to a world of hand-rolled scripts. - Puppet Labs releases its first commercial product, built on the open-source core, + Puppet Labs releases its first commercial product, built on the open source core, with paid support and enterprise features layered on top. diff --git a/why-openvox.html b/why-openvox.html index c233085..2a61ea0 100644 --- a/why-openvox.html +++ b/why-openvox.html @@ -5,7 +5,7 @@ --- Home - Why Openvox + Why OpenVox