Repository navigation
docs: fix dead Apple Containerization documentation links in README and SANDBOX - #2834
Conversation
developer.apple.com/documentation/containerization returns 404; the framework's DocC bundle is published at apple.github.io/containerization.
|
The red The same suite then passed on the retry 44 seconds later, inside the same job: This PR changes two markdown links ( |
|
One correction to my last line:
So three different suites ( Re-running the failed jobs on this PR is the cheap confirmation; I have not pushed anything to chase the red. |
|
I cannot re-run it myself ( |
# Conflicts: # README.md # docs/SANDBOX.md
tpae
left a comment
There was a problem hiding this comment.
Thanks! Apple's old Containerization docs URL now 404s. I merged main into the branch to resolve a conflict: main's README no longer links there, so the remaining fix is the one link in docs/SANDBOX.md.
What
Both places that describe the Sandbox link Apple's Containerization framework to
https://developer.apple.com/documentation/containerization, and that URL is dead - it serves Apple'sdocumentation 404 page ("The page you're looking for can't be found.").
Evidence that it is really gone (not a bot block)
developer.apple.comrenders its docs as a client-side app, so an HTTP status alone is not proof. Ichecked it in a real browser: the page loads, the nav bar renders, and the body is the heading
"The page you're looking for can't be found." with a docs search box. For comparison, a live tech
reference requested the same way in the same session returns content:
Case variants and plausible successors were all probed and all 404:
/documentation/Containerization,/documentation/containerization/framework,/documentation/containerization/frameworks,/documentation/containerizationcontainer. So the technology has nodeveloper.apple.comreferencepage right now.
Where it points instead
Apple publishes the framework's DocC documentation on its own GitHub Pages host, which is live and
complete - the root page renders the full symbol navigator (136 symbols, e.g.
ImageStore,LinuxContainer) rather than a stub:That is Apple's own org (
github.com/apple/containerization-> docs site), so it keeps the referencepointing at Apple rather than at a third-party writeup. Note that the site's shorter URLs
(
apple.github.io/containerization/and.../documentation) are DocC shell pages ~1.7 KB that onlybecome the real page once the JS bundle loads; the URL used above is the actual module root, and it is
the one I verified in a browser.
Change
Two files, one line each, link target only - no wording touched:
git show --numstatfor the commit is1 1 README.md/1 1 docs/SANDBOX.md; the repo's CRLF fileswere committed with
core.autocrlf=input, so no line-ending churn is included.Not related to this PR
I noticed PR #2669 also does README link hygiene; it fixes relative links and its diff does not touch
either of these two occurrences, so there is no overlap.