Skip to content

Releases: cvquesty/voxdocs

v1.1.0 — Sanitized & GitHub Release

27 Mar 19:52

Choose a tag to compare

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.orgexample.com
  • No personal hardware specs exposed
  • Ready for public consumption

Links

v1.0.0 — First Stable Release 🎉

12 Mar 18:21

Choose a tag to compare

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 modestrict_variables=true is now default
  • Legacy facts removed — Complete conversion table (20+ facts)
  • Hiera 3 functions removedhiera()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

12 Mar 18:18

Choose a tag to compare

What's New

🔄 Migration Guide (New!)

A comprehensive guide for migrating from Puppet 7 to OpenVox 8:

  • Strict modestrict_variables=true is now default
  • Legacy facts removed — Complete conversion table (20+ facts)
  • Hiera 3 functions removedhiera()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!

📄 Read the Migration Guide

📚 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 Lookuplookup() signatures and merge strategies
  • ⚠️ Deprecation warning for hiera(), 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).