Summary
docs/_openvox-server_8x/subcommands.markdown carries pre-OpenVox terminology and a malformed heading outline. This is content modernization only — the broken-link fixes for this collection are handled in #282, which deliberately leaves these alone to stay link-only.
Heading structure
- Lines 33–35: under
## ca, the next heading is ## Available actions (H2), making it a sibling of ca rather than a child. The other subsection of ca (### Signing certs with SANs or auth extensions, line 72) is correctly ###. Change ## Available actions to ### Available actions so the ca / gem / ruby / irb / foreground outline (and the TOC at the top) stays correct.
Terminology (per CONTRIBUTING / CLAUDE.md)
Replace the product name "Puppet Server" with "OpenVox Server" in prose (title line 3, and lines 7, 8, 31, 41, 47, 49, 74–76, 121, 159, …).
Do not rename the puppetserver command/service/binary or install paths — these ship unchanged in OpenVox and must stay verbatim. That includes puppetserver <subcommand>, puppetserver gem/ruby/irb/ca, /etc/sysconfig/puppetserver, /etc/default/puppetserver, /opt/puppetlabs/..., and puppetserver.conf.
Other stale terms to modernize:
- Lines 52–53: "master's certname" → "primary's certname"; "whitelist" → "allowlist".
- Line 66 example:
allow: master.example.com — consider a non-"master" example hostname.
Out of scope
Summary
docs/_openvox-server_8x/subcommands.markdowncarries pre-OpenVox terminology and a malformed heading outline. This is content modernization only — the broken-link fixes for this collection are handled in #282, which deliberately leaves these alone to stay link-only.Heading structure
## ca, the next heading is## Available actions(H2), making it a sibling ofcarather than a child. The other subsection ofca(### Signing certs with SANs or auth extensions, line 72) is correctly###. Change## Available actionsto### Available actionsso theca/gem/ruby/irb/foregroundoutline (and the TOC at the top) stays correct.Terminology (per CONTRIBUTING / CLAUDE.md)
Replace the product name "Puppet Server" with "OpenVox Server" in prose (title line 3, and lines 7, 8, 31, 41, 47, 49, 74–76, 121, 159, …).
Do not rename the
puppetservercommand/service/binary or install paths — these ship unchanged in OpenVox and must stay verbatim. That includespuppetserver <subcommand>,puppetserver gem/ruby/irb/ca,/etc/sysconfig/puppetserver,/etc/default/puppetserver,/opt/puppetlabs/..., andpuppetserver.conf.Other stale terms to modernize:
allow: master.example.com— consider a non-"master" example hostname.Out of scope
canonical:front-matter URL (line 4) points at upstream puppetserver docs; leave unless we have a deliberate canonical policy.