Skip to content

Fix broken links to deleted and moved pages#139

Merged
tuxmea merged 2 commits intoOpenVoxProject:masterfrom
miharp:fix/deleted-legacy-links
May 4, 2026
Merged

Fix broken links to deleted and moved pages#139
tuxmea merged 2 commits intoOpenVoxProject:masterfrom
miharp:fix/deleted-legacy-links

Conversation

@miharp
Copy link
Copy Markdown
Contributor

@miharp miharp commented May 1, 2026

Summary

  • Replace /facter/ links with /openfact/ equivalents
  • Update /guides/* links to their in-collection replacements (nodes_ldap, resources_augeas, lang_write_functions_in_puppet, bgtm, nodes_external)
  • Replace /guides/scaling_multiple_masters with /openvox-server/latest/scaling_puppet_server.html
  • Replace /trouble_regenerate_certs_* with ssl_regenerate_certificates
  • Remove dead /mcollective links (MCollective is no longer part of the package; see Remove MCollective references, replace with Choria #141)
  • Fix background/ssl/* paths to include /docs/ prefix
  • Remove references to puppet master man page, puppet cert command (removed in Puppet 6), and puppet man subcommand which no longer exist in OpenVox 8.x
  • Update ./man/ index link to ./man/overview.html
  • Fix external docs.puppet.com links in external_ssl_termination to use internal paths
  • Replace broken voxpupuli.org/docs/humans links with voxpupuli.org/connect

Helps address htmlproofer failures tracked in #120.

Test plan

Pre-merge

  • CI passes (jekyll build)
  • Confirm target pages exist in the built _site/ (spot-check a few link destinations)

Post-merge

@miharp miharp force-pushed the fix/deleted-legacy-links branch 5 times, most recently from 03d50d7 to ba723e1 Compare May 2, 2026 11:16
@miharp miharp marked this pull request as ready for review May 2, 2026 11:29
@miharp miharp requested a review from a team as a code owner May 2, 2026 11:29
@miharp miharp force-pushed the fix/deleted-legacy-links branch from ba723e1 to 947a0a5 Compare May 4, 2026 10:48
- Replace /facter/ links with /openfact/ equivalents
- Update /guides/* links to in-collection replacements (nodes_ldap,
  resources_augeas, lang_write_functions_in_puppet, bgtm, nodes_external)
- Replace /guides/scaling_multiple_masters with
  /openvox-server/latest/scaling_puppet_server.html
- Replace /trouble_regenerate_certs_* with ssl_regenerate_certificates
- Remove dead /mcollective links
- Fix background/ssl/* paths to include /docs/ prefix
- Remove references to puppet master man page, puppet cert command
  (removed in Puppet 6), and puppet man subcommand
- Update ./man/ index link to ./man/overview.html
- Fix external docs.puppet.com links in external_ssl_termination

Signed-off-by: Michael Harp <mike@mikeharp.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@miharp miharp force-pushed the fix/deleted-legacy-links branch from 947a0a5 to 2a34a13 Compare May 4, 2026 10:50
>
> **Note:**
> If you have Puppet Enterprise, you can do the steps in this guide through the PE web UI, [the console]({{pe}}/console_accessing.html).
> If you have Puppet Enterprise, you can do the steps in this guide through the PE web UI, [the console]({{pe}}https://www.puppet.com/docs/pe/latest/console_accessing.html).
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[func_ref]: ./function.html
[forge]: https://forge.puppetlabs.com
[custom]: /guides/custom_functions.html
[custom]: ./lang_write_functions_in_puppet.html
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

How about ./functions_basics.html?

Copy link
Copy Markdown
Contributor

@tuxmea tuxmea left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

2 comments

- Point custom functions link to functions_basics.html (better match for original custom_functions.html intent)
- Fix malformed PE console link ({{pe}} template var prepended to absolute URL); use help.puppet.com instead

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Signed-off-by: Michael Harp <mike@mikeharp.com>
@miharp miharp force-pushed the fix/deleted-legacy-links branch from 4ee92f4 to cf526aa Compare May 4, 2026 19:08
@tuxmea tuxmea merged commit e1f9512 into OpenVoxProject:master May 4, 2026
4 checks passed
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.

2 participants