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. π¦