Skip to content

Backport 9.x-only fixes to 8.x and correct version claims on shared pages - #496

Draft
miharp wants to merge 1 commit into
OpenVoxProject:masterfrom
miharp:docs/9x-fixes-backport
Draft

miharp wants to merge 1 commit into
OpenVoxProject:masterfrom
miharp:docs/9x-fixes-backport

Conversation

@miharp

@miharp miharp commented Sep 29, 2026

Copy link
Copy Markdown
Contributor

Part of #494 (step 1). Content fixes that are worth having whether or not the shared-source proposal is adopted, done the current dual-commit way one last time.

Backported from 9.x to 8.x

Since the 9.x collections were copied, these fixes landed in 9.x only although they apply to 8.x as well:

  • custom_types.markdown: the outdated pluginsync instructions (Puppet 2.x/3.0 wording).
  • lang_relationships.markdown and services_commands_windows.markdown: puppet agent --configprint to puppet config print.
  • OpenVox Server subcommands.markdown and puppet-api/v3/file_content.markdown: intra-product links that pointed at /openvox-server/latest/ instead of the page beside them.

8.x installer pages

install_osx.md, install_windows.markdown, and openvox_platform.md linked the generic downloads.voxpupuli.org/mac and /windows roots, which now list both series. They point at the openvox8/ directories, as the 9.x pages already point at openvox9/. This is the follow-up item listed in #456.

Version claims corrected on both trees

Three statements were identical in 8.x and 9.x and wrong somewhere:

  • Neither 8.29.0 nor 9.0.0-rc3 has a pluginsync setting in lib/puppet/defaults.rb (the word only appears in other settings' descriptions). The 8.x page told readers to set it and the 9.x page said it "was removed in OpenVox 9"; both now say it no longer exists in OpenVox.
  • format_report.markdown said report format 12 is what OpenVox 8 produces; 9.0.0-rc3 produces format 12 too, so it now says "OpenVox 8 and later".
  • ssl_custom_ca_proxy.md said openssl rehash is unsupported on Windows "as of OpenVox 8"; it is unavailable there regardless of version.

Also fixed: the 9.x openvox_platform.md still told readers to install openvox8-release.

Checks

markdownlint on the changed files, a local jekyll build, and a look at the rendered installer and platform pages. Every backported page is now byte-identical to its 9.x twin, which is what the proposal in #494 relies on.

Assisted by Claude.

@miharp
miharp force-pushed the docs/9x-fixes-backport branch from c12c046 to bb66ee3 Compare September 29, 2026 13:26
@miharp
miharp force-pushed the docs/9x-fixes-backport branch 2 times, most recently from 7f5773b to 7d1dedb Compare October 5, 2026 10:02
@miharp
miharp force-pushed the docs/9x-fixes-backport branch from 7d1dedb to 20042bd Compare October 8, 2026 11:48
…ages

Since the 9.x collections were copied, several fixes landed in 9.x only
although they apply to 8.x as well: the custom types page's outdated
pluginsync instructions, `puppet agent --configprint` in two pages
(deprecated in favor of `puppet config print`), and two OpenVox Server
pages whose intra-product links pointed at /openvox-server/latest/
instead of the page beside them. This applies each to 8.x.

The 8.x installer pages linked the generic downloads.voxpupuli.org/mac
and /windows roots, which now list both series; they point at the
openvox8 directories, as 9.x already points at openvox9 (OpenVoxProject#456). The
9.x platform page still told readers to install openvox8-release.

Three claims that were identical in both trees were wrong somewhere:
neither 8.29.0 nor 9.0.0-rc3 has a pluginsync setting at all, so
custom_types now says it no longer exists rather than "removed in
OpenVox 9"; report format 12 is what 9.0.0-rc3 produces too, so
format_report says "OpenVox 8 and later"; and `openssl rehash` is
unavailable on Windows regardless of version.

Part of OpenVoxProject#494.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Signed-off-by: Michael Harp <mike@mikeharp.com>
@miharp
miharp force-pushed the docs/9x-fixes-backport branch from 20042bd to 1ae429d Compare October 8, 2026 15:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant