Releases: cvquesty/voxdocs
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. 🦊
v0.97.0 - Migration Guide & Expanded Functions
What's New
🔄 Migration Guide (New!)
A comprehensive 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 guide - Ruby 3.2.x and OpenSSL 3.0 compatibility notes
- Package migration — Step-by-step for RHEL and Debian
- Migration checklist — Don't miss anything!
📚 Expanded Functions Reference
The language/functions.md has been significantly expanded from 42 to 192 lines:
- String Functions (case transformation, whitespace, search/replace)
- Array Functions (unique, flatten, sort, slice)
- Hash Functions (merge, keys, values, dig)
- Hiera Lookup —
lookup()signatures and merge strategies ⚠️ Deprecation warning forhiera(),hiera_array(),hiera_hash()- Type Checking and assertion
- Conditional functions (
pick,lest,then) - Utility functions (
epp,include,contain,fail)
🔍 openvox-lint Integration
Added documentation for openvox-lint in the Module Development guide:
gem install openvox-lint
openvox-lint .Technical Note: All content reviewed against official Puppet 8.10.0 documentation (52,477 lines), Puppet Best Practices (Chris Barbour), and Puppet 8 for DevOps Engineers (David Sandilands).