Skip to content

Redirect old CLI, OpenID Connect and Octopus.Client child urls - #3479

Merged
borland merged 2 commits into
mainfrom
add-cli-child-redirects
Sep 28, 2026
Merged

borland merged 2 commits into
mainfrom
add-cli-child-redirects

Conversation

@borland

@borland borland commented Sep 25, 2026 •

Copy link
Copy Markdown
Contributor

Two moves left redirects at a section's root but not at the pages beneath it, so deep links broke:

CLI reference

All in src/pages/docs/octopus-rest-api/cli/:

  • 185 command redirects, one for every page Move the CLI reference to its own top level section #3431 moved. For example, octopus-config.md redirects to https://octopus.com/docs/cli/octopus-config.
  • 125 underscore aliases restored. Move the CLI reference to its own top level section #3431 deleted the older stubs such as octopus_config.md. They're back, and they point straight at the new pages so nothing chains through a second redirect.
  • The root stub moves back to cli/index.md, where it was before the move. It still serves /docs/octopus-rest-api/cli and still redirects to /docs/cli.

OpenID Connect and Octopus.Client

Old URL (/docs/octopus-rest-api/...) Redirects to (/docs/api/...)
openid-connect/github-actions authentication/openid-connect/github-actions
openid-connect/other-issuers authentication/openid-connect/other-issuers
octopus.client/getting-started octopus.client/getting-started
octopus.client/using-client-directly octopus.client/using-client-directly
octopus.client/using-client-in-octopus octopus.client/using-client-in-octopus
octopus.client/using-resources octopus.client/using-resources
octopus.client/working-with-spaces octopus.client/working-with-spaces

The openid-connect.md and octopus.client.md parent stubs move into their folders as index.md, as the CLI one did. Their urls and targets don't change.

Checks

The stubs match the existing redirect files: same Redirect layout, frontmatter, byte-order mark and CRLF line endings. Every target was checked against the pages on disk.

🤖 Generated with Claude Code

borland and others added 2 commits September 25, 2026 14:00
Moving the CLI reference to /docs/cli (#3431) left a redirect at
/docs/octopus-rest-api/cli but none for the command pages beneath it, so
links to pages such as /docs/octopus-rest-api/cli/octopus-config broke.

Each of the 185 command pages now has a redirect stub at its old url. The
underscore aliases that #3431 deleted (octopus_config and friends) are
restored too, pointing straight at the new pages rather than chaining. The
root stub moves back to cli/index.md, where it lived before the move.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
The API move (#3439) left redirects at /docs/octopus-rest-api/openid-connect
and /docs/octopus-rest-api/octopus.client but not at the pages beneath them.
Each child page now redirects to its new home under /docs/api, and the two
parent stubs move into their folders as index.md, as the CLI one did.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
@borland borland changed the title Redirect the old CLI command urls to their new home under /docs/cli Redirect old CLI, OpenID Connect and Octopus.Client child urls Sep 25, 2026
@team-marketing-branch-protections

Copy link
Copy Markdown

Pull request environment is available at https://stoctodocspr3479.z22.web.core.windows.net/.

You can view the ephemeral environment status in Octopus Deploy.

This environment will be automatically deprovisioned when the pull request is closed, or after 7 days of inactivity.

@samwld samwld left a comment

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.

Having a . in a URL may cause you problems in the future.

@borland
borland merged commit 6aeb815 into main Sep 28, 2026
7 checks passed
@borland
borland deleted the add-cli-child-redirects branch September 28, 2026 09:34
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.

3 participants