Skip to content

website: broken redirect chain for /docs/examples/shared-resources/ — removed page is still referenced by live documentation #4440

Description

@Ishan-AI-coder

What happened

Three currently published documentation pages still link to the following URL:

/docs/examples/shared-resources/

Specifically:

  • content/en/docs/components/pipelines/legacy-v1/sdk/sdk-overview.md (around line 200)
  • content/en/docs/components/pipelines/legacy-v1/sdk/component-development.md (around line 608)
  • content/en/docs/components/pipelines/legacy-v1/sdk/build-pipeline.md (around line 234)

However, the source page for this URL (content/en/docs/examples/shared-resources.md) was removed in 2021 as part of PR #2846. That PR also introduced the following redirect rule:

content/en/_redirects

/docs/examples/*    /docs/started/kubeflow-examples

The redirect target (content/en/docs/started/kubeflow-examples.md) was subsequently removed on 13 June 2026 in PR #4385 ("community: Introduce Kubeflow Community Distribution and Kubeflow Subprojects"), but the redirect rule was never updated.

Additionally, there are two older redirect rules that still point to the removed page:

content/en/_redirects

/docs/pipelines/reusable-components/      /docs/examples/shared-resources/
/docs/pipelines/sdk/reusable-components/  /docs/examples/shared-resources/

These were introduced in PR #3737 during the Kubeflow Pipelines documentation restructuring.

As a result, there is now a broken redirect chain:

Legacy documentation
        │
        ▼
/docs/examples/shared-resources/
        │
        ▼
_redirects
        │
        ▼
/docs/started/kubeflow-examples/
        │
        ▼
Source page removed in PR #4385

Interestingly, visiting

https://www.kubeflow.org/docs/examples/shared-resources/

still serves a page titled "Shared Resources and Components" with a Last modified: 17.06.2021 footer.

Since neither the source markdown nor its redirect target exists in the current repository, this appears to be stale content being served by the deployed site rather than content generated from the current Hugo source.


Why this is a problem

  • Three live documentation pages point users to a page that no longer exists in the repository.
  • The redirect target has also been removed, leaving the redirect chain outdated.
  • The live site serves content that cannot be traced back to the current source tree, making maintenance difficult.
  • Users reaching the page have no navigation context or breadcrumb, and the content itself is several years out of date.

Steps to reproduce

  1. Visit any of the following pages:
    • /docs/components/pipelines/legacy-v1/sdk/sdk-overview/
    • /docs/components/pipelines/legacy-v1/sdk/component-development/
    • /docs/components/pipelines/legacy-v1/sdk/build-pipeline/
  2. Click the "reusable components" / "shared resources" link.
  3. Observe that:
    • /docs/examples/shared-resources/ loads successfully.
    • The page has no corresponding source markdown in the current repository.
    • There is no matching entry in the documentation navigation.
    • The footer still shows Last modified: 17.06.2021.

Repository investigation

Removed source page

content/en/docs/examples/shared-resources.md

Removed in:

Redirect rule

content/en/_redirects

/docs/examples/*    /docs/started/kubeflow-examples

Redirect target

content/en/docs/started/kubeflow-examples.md

Removed in:

Additional redirects

/docs/pipelines/reusable-components/
/docs/pipelines/sdk/reusable-components/

Both still redirect to:

/docs/examples/shared-resources/

Suggested fix

A possible approach would be to:

  1. Update or remove the outdated redirect rules in content/en/_redirects.
  2. Replace the three in-repository links with an appropriate current destination (or remove them if the referenced content is no longer maintained).
  3. Verify whether the deployed site is serving stale cached content, as the current repository no longer contains either:
    • the original markdown source, or
    • the configured redirect target.

Environment

Metadata

Metadata

Labels

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions