Releases: cvquesty/voxdocs
Releases · cvquesty/voxdocs
Release list
v2.3.0
v2.2.0
v2.1.2
v2.1.1
v2.1.0
v2.0.8
v2.0.5 - Alignment with official OpenVox documentation project
Alignment pass against the official OpenVox documentation project
Reviewed and synthesized content from the official OpenVox documentation (github.com/OpenVoxProject/openvox-docs) into VoxDocs.
Version updates
- OpenVoxDB version updated from "8.x" to 8.8.1
- Added Ruby 3.2.11 / OpenSSL 3.0.20 component details for openvox-agent 8.26.2
Platform support
- Added full Supported Platforms table from openvox-docs system requirements (RHEL 7-10, SLES 15-16, Debian 10-13, Ubuntu 18.04-26.04, Fedora 36-43, Windows, macOS, plus unofficial platforms)
PDK alternatives
- Replaced bare PDK section with "PDK and Open-Source Alternatives" noting PDK 3.4.0 was the last OSS version; documented VoxBox (Vox Pupuli container) and jig (Go-based reimplementation)
Copyright and licensing
- Updated "A Note on Copyright & Originality" to reference openvox-docs as a source (CC BY-SA 3.0, copyright Puppet, Inc.)
- Added Attribution subsection to License section with proper credit
- Updated AGENTS.md copyright policy to permit referencing openvox-docs for factual data
Full Changelog: v2.0.0...v2.0.5
VoxDocs 2.0.0 — OpenVox Project Alignment
VoxDocs 2.0.0 — OpenVox Project Alignment
VoxDocs 2.0 brings the community documentation into alignment with the official OpenVox documentation project and the platform's current state on RHEL 9.7.
Why a Major Version?
The conceptual framing of the project has shifted enough that returning readers will encounter new terminology and a restructured introduction:
- The OpenVox team has rebranded several core components. Facter is now OpenFact, PuppetDB is now OpenVoxDB, and Bolt is now OpenBolt. Binary names (
facter,puppetdb,bolt) and config files (facter.conf) are unchanged — only project/package names changed. - The official origin story has been refined. It now credits Overlook InfraTech for stepping in with community packaging when Perforce discontinued public distribution of open-source Puppet in late 2024, before Vox Pupuli adopted the project.
- A Puppet Standards Steering Committee now guides language and feature evolution.
- The documented package set has expanded to include
openvoxdb,openvoxdb-termini, andopenboltas first-class members.
No documentation files were removed. Users on v1.x can continue using v1.1.0 as a snapshot reference.
Highlights
Version bumps (all verified against the live RHEL 9.7 lab)
| Component | v1.x | v2.0.0 |
|---|---|---|
| openvox-agent | 8.25.0 | 8.26.2 |
| OpenVox Server | 8.12.1 | 8.12.1 (unchanged) |
| OpenFact (was Facter) | 5.4.0 | 5.6.0 |
| OpenBolt (was Bolt) | 5.3.0 | 5.4.0 |
| r10k | 5.0.2 | 5.0.2 (unchanged) |
New & expanded sections
- README — new "A Brief History" section covering the Perforce → Overlook InfraTech → Vox Pupuli timeline; expanded versions table with package paths; Windows / macOS download URLs; links to the official Installing OpenVox and Support pages and the official docs repo.
- Getting Started — new "Windows and macOS Agents" subsection; new "Full OpenVox Package Set" subsection covering
openvox-agent,openvox-server,openvoxdb,openvoxdb-termini,openbolt; verification snippets for OpenFact and PuppetServer. - Migration Guide — new "Two migration paths" callout (Puppet 7 → OpenVox 7 → OpenVox 8 vs. Puppet 7 → Puppet 8 → OpenVox 8); new "Upgrade Order" subsection (server → openvoxdb → termini → agent); explicit warning that Puppet and OpenVox cannot coexist on the same host.
- Architecture — branding callouts in the PuppetDB and Facter sections explaining the OpenVoxDB / OpenFact rename; OpenFact, OpenVoxDB, and OpenBolt added to the glossary.
- CLI Reference — version banner now enumerates the actual lab package set; refreshed
puppet --help,puppet --version,bolt --version, andfacter --versioncaptures from the live lab; OpenVoxDB row added to the Server & Infrastructure table. - Server Admin — PostgreSQL recommendation bumped to PostgreSQL 14+ (still requires 11+) with PGDG repo links, matching official OpenVoxDB 8 guidance.
- Troubleshooting — new FAQ entry for the cosmetic
puppet --versionreporting bug in OpenVox 8.26.2 (OpenVoxProject/openvox#415). - Community — acknowledgments expanded to call out Overlook InfraTech's role and the Puppet Standards Steering Committee.
- Orchestration —
openboltdocumented as the preferred package name alongside the legacypuppet-bolt.
Known issue documented
OpenVox 8.26.2 has a cosmetic bug where puppet --version reports 8.26.1. The agent itself is at the correct version — this affects the version string only. Tracked at OpenVoxProject/openvox#415. Verify the real package version with rpm -q openvox-agent or dpkg -l openvox-agent.
Diff stats
14 files changed, +218 / -27.
License
CC BY-SA 4.0. Original community-written work; no Perforce/Puppet documentation copied. All CLI output captured from a live RHEL 9.7 OpenVox lab.
Built with coffee, sudo access, and mild frustration by the community.
v1.1.0 — Sanitized & GitHub Release
VoxDocs reaches GitHub! This release contains the complete OpenVox community documentation, sanitized for public consumption.
What's Included
- 🚀 Getting Started — Installation, first manifest, agent-server setup
- 🏗️ Architecture — Components, data flow, environments, modules
- 📝 Language Reference — 14 topic pages covering the full Puppet DSL
- ⌨️ CLI Reference — 16 command pages with real output
- ⚙️ Configuration — puppet.conf, hiera.yaml, all settings
- 🖥️ Server Administration — PuppetServer, PuppetDB, CA management
- 📚 Hiera Deep-Dive — Hierarchies, merge strategies, eyaml
- 📦 Module Development — Roles/profiles, testing, publishing
- 🎯 Orchestration — Bolt, r10k, tasks and plans
- 🔧 Troubleshooting — Common issues and solutions
- 🤝 Community — Contributing, resources, support
This Release
- All personal info removed (domain, username, hardware details)
- Published to github.com/cvquesty/voxdocs
- 46 files, 7343 lines of documentation
- CC BY-SA 4.0 licensed
What's New
- Sanitized: all
questy.org→example.com - No personal hardware specs exposed
- Ready for public consumption
Links
v1.0.0 — First Stable Release 🎉
VoxDocs 1.0.0 — First Stable Release! 🎉
The OpenVox community documentation is now production-ready.
📚 Complete Documentation Coverage
| Section | Description |
|---|---|
| 🚀 Getting Started | Installation, first manifest, agent-server setup, migration guide |
| 🏗️ Architecture | Components, data flow, environments, module system |
| 📝 Language Reference | 14 topic pages covering the full Puppet DSL |
| ⌨️ CLI Reference | 16 command pages with real output from live infrastructure |
| ⚙️ Configuration | puppet.conf, hiera.yaml, all settings |
| 🖥️ Server Administration | PuppetServer, PuppetDB, CA management |
| 📚 Hiera Deep-Dive | Hierarchies, merge strategies, eyaml encryption |
| 📦 Module Development | Roles/profiles, testing, linting, publishing |
| 🎯 Orchestration | Bolt, r10k, tasks and plans |
| 🔧 Troubleshooting | Common issues and solutions |
| 🤝 Community | Contributing, resources, support channels |
🔄 Migration Guide (New in 0.97.0)
Complete guide for migrating from Puppet 7 to OpenVox 8:
- Strict mode —
strict_variables=trueis now default - Legacy facts removed — Complete conversion table (20+ facts)
- Hiera 3 functions removed —
hiera()→lookup()migration - Ruby 3.2.x and OpenSSL 3.0 compatibility
- Package migration — Step-by-step for RHEL and Debian
- Migration checklist — Don't miss anything!
✅ Technical Verification
All content reviewed against:
- 📖 Official Puppet 8.10.0 documentation (52,477 lines)
- 📘 Puppet Best Practices by Chris Barbour
- 📗 Puppet 8 for DevOps Engineers by David Sandilands
🛠️ Tools Integration
- openvox-lint — Community linter for style guide, legacy facts, Hiera 3 deprecation
- openvox-gui — Web management UI
📄 License
This documentation is released under CC BY-SA 4.0.
Built by the community, for the community. 🦊