Skip to content

[Bug] Broken Link: Search results on docs.temporal.io return 404 for learn.temporal.io tutorial sections #4274

@dewan-ahmed

Description

@dewan-ahmed

Temporal Affiliation

* [ ] I am a Temporal employee

Page URL

https://docs.temporal.io/tutorials/ai/building-mcp-tools-with-temporal/adding-hitl-to-mcp-tools/#step-3-adding-signals-for-human-approval

Technical Issue

What are you really trying to do?

Learn about "approval signals" on https://docs.temporal.io

https://github.com/user-attachments/assets/db677a4b-9f00-425b-ba3d-5a0e6d047478!

My.Movie.mp4

Describe the bug

When searching for "approval signals" on https://docs.temporal.io, the search
results include multiple sections from the tutorial "Building Durable MCP Tools With Temporal".
All of the returned section links lead to a "Page Not Found" error when clicked.

All links result in a "Page Not Found" (404) error. It appears that https://docs.temporal.io/tutorials/ai/building-mcp-tools-with-temporal/adding-hitl-to-mcp-tools/#step-3-adding-signals-for-human-approval (and other sections) has moved to
https://learn.temporal.io/tutorials/ai/building-mcp-tools-with-temporal/adding-hitl-to-mcp-tools/#step-3-adding-signals-for-human-approval but it hasn't been updated in some places.

Minimal Reproduction

# Navigate to https://docs.temporal.io
# Open the search bar
# Search for "approval signals"
# Click any of the following results listed under "Building Durable MCP Tools With Temporal":
** Using Wait Conditions to Pause Execution
** Defining Signal Methods
** Adding Workflow State
** What are Signals?
** Understanding the Human-in-the-Loop Pattern

Environment/Versions

* URL: https://docs.temporal.io (using the search function)
* Browser: Chrome
* Date observed: March 2026

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions