Skip to content

[Docs] Multiple broken documentation links in README (stale URLs after docs restructure) #340

Description

Summary

The README.md contains multiple broken links to the documentation site (microsoft.github.io/UFO). All of them return HTTP 404. The links appear to have been valid under the previous documentation URL structure but were not updated when the docs site was reorganized (old flat namespace → prefixed ufo2/, configuration/, tutorials/ structure).

Affected URLs

All confirmed broken (HTTP 404). For most, I was able to locate the current working page; four I could not confirm:

Broken URL (in README) Current working replacement
/advanced_usage/control_detection/hybrid_detection /ufo2/core_features/control_detection/hybrid_detection/ ✅ 200
/advanced_usage/multi_action /ufo2/core_features/multi_action/ ✅ 200
/advanced_usage/overview/ /ufo2/overview/ ✅ 200
/advanced_usage/reinforce_appagent/overview/ /tutorials/creating_app_agent/overview/ ✅ 200
/supported_models/overview/ /configuration/models/overview/ ✅ 200
/automator/overview ❓ Not found in current nav
/galaxy/core/overview/ ❓ Not found in current mkdocs.yml
/galaxy/session/overview/ ❓ Not found in current mkdocs.yml
/galaxy/visualization/overview/ ❓ Not found in current mkdocs.yml

Steps to reproduce

curl -I https://microsoft.github.io/UFO/advanced_usage/control_detection/hybrid_detection
# -> HTTP/2 404

Each URL in the "Broken" column returns 404; each listed replacement returns 200.

Root cause

The documentation site structure was reorganized (likely part of the UFO3/Galaxy update). The README links were not updated to match the new paths.

Proposed fix

Update the affected links in README.md to the current documentation URLs. For the three URLs I could not confirm (/automator/overview, /galaxy/core/overview/, /galaxy/session/overview/, /galaxy/visualization/overview/), maintainer guidance on the correct new paths — or confirmation that those pages were removed — would help before fixing them.

I'm happy to open a PR against pre-release with the confirmed replacements.

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