docs: remove orphaned placeholder pages#389
Merged
Merged
Conversation
Several documentation pages carried over from the docs-page and scs-docs subtree merges were never wired into the consolidated sidebar. They contained only a heading and a "TODO" placeholder and were unreachable: no sidebar entry, no inbound links, and not covered by any autogenerated directory. Delete the 17 dead placeholder pages under the IaaS overview, Container Layer (overview, deployment example A, guide1) and Operating SCS (overview plus the monitoring, incident-management, audits, lifecycle-management and logging sections) trees. Strip the now-dangling references from sidebarsDocs.js: the Container Layer Overview, Deployment Examples and Guides categories held nothing but commented-out entries pointing at the deleted files, so they would have rendered as empty generated-index pages; remove them along with the commented-out operating-scs/overview entry. The Container Layer category now resolves directly to Components, its only populated subsection. No real content is removed and no live link or sidebar entry referenced any of these files, so the build is unaffected. DocImpact Assisted-by: Claude:claude-opus-4-8 Signed-off-by: Jan Klare <klare@osism.tech>
mbuechse
approved these changes
Jul 24, 2026
mbuechse
left a comment
mbuechse
left a comment
Contributor
There was a problem hiding this comment.
LGTM. Not sure we want to keep docs/07-standards/index.md. We could move standards to docs/07-standards, but this would replace said file anyway.
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
2 participants
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 17 dead documentation pages that were carried over from the
docs-page/scs-docssubtree merges but never wired into the consolidated sidebar. Each contained only a heading plus aTODOplaceholder and was unreachable — no sidebar entry, no inbound links, and not covered by any autogenerated directory.Deleted trees:
docs/02-iaas/overview/— architecture, compute, knowledge, network, storagedocs/03-container/overview/— architecture, knowledgedocs/03-container/deployment-examples/a/— index, hardware, softwaredocs/03-container/guides/guide1.mddocs/04-operating-scs/overview.mdand the02-monitoring,03-incident-management,04-audits,05-lifecycle-management,06-loggingindex pagesSidebar cleanup
sidebarsDocs.jsheld dangling references to the deleted files:generated-indexpages — removed. Container Layer now resolves directly to Components, its only populated subsection.operating-scs/overviewentry was removed.Impact
No real content is removed and no live link or sidebar entry referenced any of these files, so the build is unaffected.
Not included
Three orphaned pages that contain real content were intentionally left in place, as they likely want re-linking rather than deletion:
docs/01-getting-started/preinstall-checklist.md,docs/05-iam/iaas-roles.md, anddocs/07-standards/index.md.🤖 Generated with Claude Code