docs: remove unpublished root-level pages - #2380
Merged
theojin merged 1 commit intoAug 26, 2026
Merged
Conversation
get-started.md, glossary.md, and menu.yaml have no publishing path. The only active consumer of master is the tizen.org.v2.docs pipeline, which copies files by slicing the TOCs it reads; none of the eleven TOC roots or seven fixed-file inputs reach these pages, and they appear zero times in the committed source manifests. All three return 404 on samsungtizenos.com, and no published document links to them. menu.yaml configured the top navigation of the legacy DocFX site, which builds from the live branch. That branch has not moved since 2025-11-20. docs/images/ held a single icon referenced only by get-started.md, so the directory goes with it. The identically named icon used by application/dotnet/learn-about-dotnet.md is a separate file under that section's own media/ directory. trademarks.md is deliberately kept. It is the third-party trademark attribution page introduced in 57b3f30 so that individual pages could drop the (R), (TM), and (C) symbols, and 144 currently published documents still carry those symbols. The new site has no equivalent page: its terms-of-use covers only Samsung's own intellectual property. Its missing publishing path is filed separately.
Collaborator
Author
|
Clean removal of three unreachable root-level pages ( The PR description is thorough: it verifies unreachability through the pipeline TOC slicing, source manifests, and the published sitemap, and confirms the |
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.
What
Removes three root-level pages under
docs/that have no publishing path, plus the single image only they used.docs/get-started.mddocs/glossary.mddocs/menu.yamldocs/images/ic_docs_download.pngget-started.mddocs/images/held that one icon, so the directory goes with it. The identically named icon used byapplication/dotnet/learn-about-dotnet.mdis a separate file under that section's ownmedia/directory and is untouched.Why these are unreachable
The only active consumer of
masteris thetizen.org.v2.docspipeline, which copies files by slicing the TOCs it reads. I checked all eleven TOC roots and seven fixed-file inputs it uses:glossary.mdhas an entry indocs/application/toc_all.md, but that TOC is only consumed through prefix slices (/application/dotnet/{get-started,guides,reference}/,/application/native/{guides,reference}/,/application/web/{guides,reference,tutorials}/)./glossary.mdfalls in none of them.get-started.mdis referenced only fromdocs/platform/toc_all.md, which no work script reads.menu.yamlconfigured the top navigation of the legacy DocFX site. Nothing in eithertizen.org.v2.docsortizen.org.v2reads it.None of the three appears in the committed source manifests (
storage/docs/**/{toc.md,toc.json},storage/documents/**/import.json), and no published document links to any of them.The legacy site still serves these pages, but it builds from the
livebranch, which has not moved since 2025-11-20. Content removed frommastersince then — the IoT, partners, and blog sections, the OpenGL ES guides — is still served there too.trademarks.md is deliberately kept
It is the third-party trademark attribution page added in 57b3f30 ("Add trademarks page and remove symbols from pages under open-source-project") so individual pages could drop the ®, ™, and © symbols. 144 currently published documents still carry those symbols, and the marks themselves appear throughout the corpus (Wi-Fi 20,883 occurrences, Java 2,235, OpenGL 1,757, Windows 1,702, and so on).
The new site has no equivalent: its
terms-of-usecovers only Samsung's own intellectual property, and/trademarksreturns 404. Its missing publishing path is a separate problem from this cleanup and is filed separately. Its TOC entry inapplication/toc_all.mdand the sentence inapplication/index.mdare both left in place.Verification
python3 tools/check_docs.py docsover the whole tree — no findings.tizen.org.v2.docspipeline twice with--section-only, once againstmasterand once against this branch, over the eight sections that consumeapplication/toc_all.md. Output is identical: same 1,729 files, every Markdown file byte-for-byte equal, and the eighttoc.jsonfiles differ only in their run timestamps.scripts/pages/audit-ssot-coverage.jsagainst the published sitemaps reportswork script input missing 0, and none of these files appears anywhere in the report, includingwrongly_deleted./docs/<single-segment>depth, so these pages have no live URL to lose.Also updated
Inbound references, so the link checker stays clean: the
Glossaryentry inapplication/toc_all.md, theget-startedentry inplatform/toc_all.md, theGlossarysentence inapplication/index.md, the repository tree inREADME.md, and the skill'sdirectory-map.md.