Skip to content

Conversation

@bezarsnba
Copy link
Contributor

@bezarsnba bezarsnba commented Oct 23, 2025

Problem

Several CLI commands contain documentation URLs that return 404 errors because they reference non-existent README.md files in chart directories. This creates a poor user experience when developers try to access
configuration documentation through CLI help commands.

The affected commands are:

  • linkerd upgrade: references charts/linkerd2/README.md
  • linkerd multicluster install: references linkerd-multicluster/README.md
  • linkerd multicluster link: references linkerd-multicluster-link/README.md
  • Chart documentation template also references broken README links

Solution

Updated all affected CLI help text and chart documentation to point
directly to the corresponding values.yaml files, which contain the
actual configurable values that users need.

Changes made:

  • Fixed URL in cli/cmd/upgrade.go from charts/linkerd2/README.md to
    charts/linkerd-control-plane/values.yaml
  • Fixed URL in multicluster/cmd/install.go from linkerd-multicluster/README.md
    to linkerd-multicluster/values.yaml
  • Fixed URL in multicluster/cmd/link.go from linkerd-multicluster-link/README.md
    to linkerd-multicluster-link/values.yaml
  • Updated chart template in charts/linkerd-control-plane/README.md.gotmpl
    to reference values.yaml files

Validation

Manually tested the following commands to verify help text shows correct URLs:

  • linkerd upgrade --help
  • linkerd multicluster install --help
  • linkerd multicluster link --help

Verified that all updated URLs now point to existing files containing
configuration documentation.

Fix: #14652

@bezarsnba bezarsnba requested a review from a team as a code owner October 23, 2025 00:32
Copy link
Member

@adleong adleong left a comment

Choose a reason for hiding this comment

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

Thank you for this fix!

@bezarsnba bezarsnba requested a review from adleong November 7, 2025 19:06
@cratelyn cratelyn enabled auto-merge (squash) November 12, 2025 17:03
@bezarsnba
Copy link
Contributor Author

bezarsnba commented Nov 12, 2025

Hi @adleong and @cratelyn , I saw that this workflow failed: linkerd/linkerd2/actions/runs/19178511645

Do I need to do anything?

@cratelyn cratelyn merged commit 193c7e4 into linkerd:main Nov 13, 2025
65 of 68 checks passed
@cratelyn
Copy link
Member

Hi @adleong and @cratelyn , I saw that this workflow failed: linkerd/linkerd2/actions/runs/19178511645

Do I need to do anything?

you're good to go! a test had flaked, and just needed to be run once again. this is now merged! thank you again for opening this pull request, and for your patience, @bezarsnba.

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.

Broken documentation URLs in CLI help commands return 404 errors

3 participants