docs/_openvoxdb_8x: Clean up and modernize collection

[miharp]

The _openvoxdb_8x collection was ported from PuppetDB docs and needs a systematic
cleanup pass. 95 files, ~1,933 instances of upstream branding to update, plus structural
and content issues found in a thorough audit.

1. Rebrand (highest priority — pervasive) ✅ Done in #207

• Replace PuppetDB / puppetdb → OpenVoxDB / openvoxdb across all 95 files
• Update GitHub links from github.com/puppetlabs/puppetdb → github.com/OpenVoxProject/openvoxdb
• Update Forge module URLs → https://forge.puppet.com/modules/puppet/openvoxdb
• Audit Puppet®, Puppet Labs references — removed "generated by Puppet®", "Puppet Labs® issue tracker", "Puppet Labs Status API" framing
• Update CONTRIBUTING.md — Jira tracker link replaced with GitHub issues
• Replace remaining "PuppetDB" references in _data/nav/openvoxdb_8x.yml

Intentionally deferred from rebrand scope:

• Review PE-only feature markers (ha.markdown and others marked "PE-only") — clarify which features are available in open-source OpenVoxDB ✅ Done in openvoxdb_8x: remove PE-only HA, sync, and extensions content #217
• Update puppet.com/docs/puppet/latest/ external links → /openvox/latest/ equivalents (see comment below for full audit) ✅ Done in openvoxdb_8x: update puppet.com/docs links to openvox equivalents #228

2. Structural fixes (quick wins)

• Remove duplicate: index.md and overview.markdown have identical content — remove one, keep the other
• Add missing YAML frontmatter to acceptance_tests.markdown (currently has none)
• Add missing YAML frontmatter to configure_postgres.markdown (currently has none)
• Audit ~22 pages not linked from _data/nav/openvoxdb_8x.yml — add them, or decide to intentionally omit them (down from ~62; API v4 query endpoints, PQL/AST docs, tutorials, curl tips, and most wire formats were already added to nav):
  • Operational: logging.html, migration_coordination.html, testing_storage_changes.html, acceptance_tests.html
  • Older wire format versions (likely intentional): catalog v6–v8, facts v4, reports v5–v7
  • Missing wire formats: catalog_inputs_format_v1.html, configure_expiration_format_v1.html
  • Missing query endpoints: api/query/v4/catalog_inputs.html, catalog_input_contents.html

3. Content accuracy

• Fix placeholder/corrupted text: xxxxxz string in release_notes_6.markdown
• Fix "Puppet DB" (with space) → "OpenVoxDB" in release_notes_6.3.markdown
• Update PostgreSQL version support table — clarify what OpenVoxDB 8.x actually supports vs legacy versions
• Remove or update "Experimental" label on PQL in api/query/v4/pql.markdown (PQL is stable)
• Review deprecated Metrics API docs (api/metrics/v2/jolokia.markdown) — update or add deprecation notice
• Fix outdated external links:
  • PostgreSQL docs URLs using old /static/ path format
  • puppet.com/docs/puppetdb/latest/configure.html#vardir in maintain_and_tune.markdown → internal link
  • Note: tickets.puppetlabs.com Jira links and forge.puppetlabs.com URLs were fixed in rebrand openvoxdb_8x: PuppetDB -> OpenVoxDB throughout #207

4. Release notes cleanup

• Resolve overlap between release_notes.markdown and release_notes_8.markdown (appear to cover same 8.x content)
• Decide whether to archive release_notes_older.markdown (191KB, covers PDB 1–5 history) — keeping for now per project decision

Notes

• Old release notes for PuppetDB 1–7 (release_notes_older.markdown, release_notes_5.2.markdown, etc.) are intentionally left as historical record — no changes needed there
• Technical names kept as-is (verified against https://github.com/voxpupuli/puppet-openvoxdb): service name puppetdb, system paths /etc/puppetlabs/puppetdb/, database name puppetdb, [puppetdb] INI section, storeconfigs_backend = puppetdb, reports = store,puppetdb, puppetdb.conf filename

[miharp]

External puppet.com link audit

As part of the rebrand work, audited all puppet.com/docs links in _openvoxdb_8x. A separate PR will update the ones that have OpenVox equivalents.

Will be updated (target page exists in OpenVox docs):

• 14× puppet.com/docs/puppet/latest/ links → /openvox/latest/...
  • lang_exported, lang_resources, lang_relationships, lang_data_undef, lang_data_resource_reference, lang_data_number, lang_containment, format_report, lang_summary, lang_facts_and_builtin_vars, config_file_routes, reporting_about, dirs_confdir, install_pre
• puppet.com/docs/puppetserver/latest/config_file_puppetserver.html → /openvox-server/latest/config_file_puppetserver.html
• puppet.com/docs/puppetdb/latest/configure.html#vardir → /openvoxdb/latest/configure.html#vardir

Keep as external / no OpenVox equivalent found:

• install_puppet.html, configuration.html, type.html, custom_facts.html, puppet_platform.html — not yet present in _openvox_8x
• 4× puppet.com/docs/pe/latest/ links — PE-specific, no OpenVox equivalent

[miharp]

CONTRIBUTING.md dead links (found during PR #228 review)

The Additional Resources section at the bottom of _openvoxdb_8x/CONTRIBUTING.md has several dead/outdated links:

• https://docs.puppet.com/community/community_guidelines.html — 404 (no redirect)
• http://tickets.puppetlabs.com — defunct Jira tracker (already noted as replaced in rebrand openvoxdb_8x: PuppetDB -> OpenVoxDB throughout #207 body text, but this footer still references it)
• http://links.puppetlabs.com/cla — likely dead CLA link
• #puppet-dev IRC channel on freenode.org — freenode is effectively defunct

These should be updated or removed in a follow-on pass. A Vox Pupuli community guidelines equivalent may exist at https://voxpupuli.org.