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.
Summary
The
README.mdcontains 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 → prefixedufo2/,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:
/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/galaxy/core/overview/mkdocs.yml/galaxy/session/overview/mkdocs.yml/galaxy/visualization/overview/mkdocs.ymlSteps to reproduce
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.mdto 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-releasewith the confirmed replacements.