docs: restore 11 pages that are still live on the docs site - #2364
Merged
Conversation
The recent cleanup commits removed 11 documents that are still published and reachable on the live documentation site. Restoring them prevents those URLs from turning into 404s on the next publish. Four of them are section landing pages. The site redirects each section root to its overview page, so removing them breaks the entry point to the whole section rather than a single page: /docs/application/dotnet -> /docs/application/dotnet/overview /docs/application/native -> /docs/application/native/overview /docs/application/web -> /docs/application/web/overview /docs/application/flutter -> /docs/application/flutter/overview These overview pages are not listed as children in any TOC, which is likely why they were classified as unlisted content. The remaining seven are guide and reference pages that are not specific to the Mobile or Wearable profiles, so they appear to have been swept up by the profile cleanup: dotnet/guides/notification/attach-panel native/guides/text-input/capi-ui-gesture native/reference/security-privileges-legacy web/guides/applications/web-widget web/guides/multimedia/camera web/reference/security-privileges-legacy extensions/tizenx/overview Each file is restored byte-for-byte from the commit immediately before its deletion. No content was edited. Restored from: 63609d5, edca393, d0e1881, 25cf656
Collaborator
|
Can one of the admins verify this patch? |
1 similar comment
Collaborator
|
Can one of the admins verify this patch? |
…he site The restored pages carried three links whose targets are not published, so they returned 404 on the live site. Each was verified with a request before and after the change. 1. dotnet/overview -> ../api/dotnet-standard-limitations.md The target file exists in this repository but is not published, and there is no published equivalent. The link is dropped and the warning itself is kept, so the caveat survives without a dead pointer. 2. native/overview -> ../api/overview.md Same situation: an unpublished hub page. The native API reference is published only as versioned group pages with no landing page, and no other published guide links to it, so there is nothing to retarget to. The bullet is removed; the neighbouring Guides link is unaffected. 3. web/overview -> ../guides/security/security.md Here the target does not exist at all, but the content does. In the site TOC, Security is a group node with an empty path - a category with no page of its own - while its three child pages are published. The dead link is replaced by that same structure: Security as a plain label with its three published pages beneath it. All 16 internal links across the restored files now resolve to published pages.
mindol
approved these changes
Aug 18, 2026
mindol
left a comment
Collaborator
There was a problem hiding this comment.
Looks good to me.
고생하셨습니다.
theojin
added a commit
that referenced
this pull request
Aug 18, 2026
#2364 restored eleven of the same pages first, so `web-widget.md` and `camera.md` arrived on both sides. The two blobs are byte-identical — the conflict is only a file mode difference (this branch added them 100644, master restored them 100755). Took master's mode. Those files sit next to `audio.md`, `jpeg-exif.md` and `media-controller.md`, which are all 100755, so 100755 is what they had before deletion and what the directory uses. Both files now match master exactly, so the merge is a no-op for them. No other conflicts, and no mode-only churn anywhere else.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Change Description
Restores 11 documents that were removed by the recent cleanup commits but are still published and reachable on the live documentation site. Every restored file is verified to return HTTP 200 today. Without this, those URLs become 404s on the next publish.
Each file is restored byte-for-byte from the commit immediately before its deletion. No content was edited.
1. Section landing pages (4)
The site redirects each section root to its overview page:
/docs/application/dotnet/docs/application/dotnet/overview/docs/application/native/docs/application/native/overview/docs/application/web/docs/application/web/overview/docs/application/flutter/docs/application/flutter/overviewSo removing these does not just drop one page — it breaks the entry point to the entire section. Following the ".NET" entry in the navigation would land on a 404, even though the 24,000+ pages underneath remain reachable by direct URL.
These pages are not listed as children in any TOC, which is most likely why they were classified as unlisted content. Being unlisted is what makes them landing pages, not what makes them obsolete.
Also restored for the same reason:
extensions/tizenx/overview.md.2. Pages not specific to Mobile or Wearable (6)
These appear to have been swept up by the profile cleanup even though they are not profile-specific:
application/dotnet/guides/notification/attach-panel.mdapplication/native/guides/text-input/capi-ui-gesture.mdapplication/native/reference/security-privileges-legacy.mdapplication/web/guides/applications/web-widget.mdapplication/web/guides/multimedia/camera.mdapplication/web/reference/security-privileges-legacy.mdHow these 11 were identified
Two independent signals were cross-checked against the 433 markdown files deleted in
63609d51d,edca393fb,d0e188132,26c727a41,25cf65689and532a525fe:Signal 2 turned out to be a strict subset of signal 1. The four extra entries in signal 1 are exactly the overview sections, which have no TOC entry for signal 2 to see — a self-consistent explanation rather than a discrepancy. All 11 were then confirmed individually with a live request.
The opposite direction was checked as well: a 20-file sample of the deletions classified as safe all returned 404 (legacy
design/*,tizen-studio-0/*, and EFL Mobile/Wearable content). The other 422 deletions look correct and are intentionally left untouched — this PR does not revert those commits, it only restores individual files.Dead links repaired (second commit)
Checking the restored pages against the live site turned up three links whose targets are not published and therefore 404, not just the one originally flagged. All three are fixed in the second commit, and each was verified with a request before and after.
dotnet/overview../api/dotnet-standard-limitations.mdnative/overview../api/overview.mdweb/overview../guides/security/security.mdTwo of the three point at
api/overview.md-style hub pages that live in this repository but never reach the site, so the links work in the GitHub file view and break once published. There is no published landing page for either the .NET or the native API reference — the native reference exists only as versioned group pages, and no other published guide links to it — so there was nothing to retarget to. The links are removed and the surrounding prose is kept intact.The third is different: the target file is genuinely gone, but the content is not. In the site TOC,
Securityis a group node with an empty path — a category with no page of its own — while its three child pages are published. The dead link is replaced with that same shape:This keeps the category visible in the guide list instead of dropping it, and every link resolves. Happy to collapse it back to a single bullet if you would rather keep the list flat.
All 16 internal links across the 11 restored files now resolve to published pages.
To rule out the obvious suspicion, the first two targets were checked against history: they are not casualties of the recent cleanup.
dotnet-standard-limitations.mdhas not been modified since 2018 andnative/api/overview.mdsince 2025-09, and both files are present in the tree today, so there is no earlier revision to restore. They are simply outside the current publishing scope — the .NET API section is generated from TizenFX, and the native API section walks version folders only — which is why the pages never appear on the site.One note for follow-up, outside this PR:
dotnet-standard-limitations.mdis not stale legacy content. It documents real constraints that still apply (redirected standard output,Process.GetProcesses()throwing), and that information appears nowhere on the published site. Whether it should be brought into the published set is a docs-ownership decision rather than a link fix, so nothing here changes it.Bugs Fixed
N/A
API Changes
N/A