Skip to content

fix: replace broken pup.pt documentation links with help.puppet.com#3401

Open
raman1236 wants to merge 1 commit intopuppetlabs:mainfrom
raman1236:fix/update-broken-documentation-links
Open

fix: replace broken pup.pt documentation links with help.puppet.com#3401
raman1236 wants to merge 1 commit intopuppetlabs:mainfrom
raman1236:fix/update-broken-documentation-links

Conversation

@raman1236
Copy link
Copy Markdown

Description

Replace all broken pup.pt documentation links with their equivalent pages on the current Puppet documentation site at help.puppet.com.

Problem

The pup.pt URL shortener is no longer reachable. This affects documentation links throughout the Bolt CLI, including:

  • Help text for all bolt subcommands (apply, command, file, lookup, plan, plugin, script, secret, task)
  • Error messages and warnings
  • Guide YAML files displayed via bolt guide
  • Comments in generated files (Puppetfile, plan templates)

Changes

Updated all references across 22 files:

  • lib/bolt/bolt_option_parser.rb - CLI help text
  • lib/bolt/module_installer/specs.rb - module validation error
  • lib/bolt/module_installer/puppetfile.rb - Puppetfile comments
  • lib/bolt/outputter/human.rb - plugin help output
  • lib/bolt/analytics.rb - analytics notice
  • lib/bolt/config/options.rb - config documentation reference
  • lib/bolt/inventory/target.rb - dotted facts warning
  • lib/bolt/inventory/options.rb - plugin hooks reference
  • lib/bolt/plan_creator.rb - plan template comments
  • lib/bolt/project_manager.rb - inventory reference
  • lib/bolt/project_manager/inventory_migrator.rb - migration message
  • lib/bolt/project_manager/module_migrator.rb - migration message
  • lib/bolt/shell/bash.rb - task failure help
  • guides/*.yaml - all guide files

All links now use https:// and point to help.puppet.com/bolt/current/topics/.

Fixes #3386

The pup.pt URL shortener is no longer reachable, causing all
documentation links in the CLI help text, error messages, and
guide files to be broken.

Replace all pup.pt URLs with their equivalent pages on the
current Puppet documentation site at help.puppet.com.

Fixes puppetlabs#3386
@raman1236 raman1236 requested review from a team as code owners April 5, 2026 23:57
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.

https://pup.pt links in the CLI are broken

2 participants