Fix blank enterprise-rollout section landing pages - #78
Merged
Conversation
The 8 subsection _index.md files under enterprise-rollout contained only front matter and no body, so every link under the binder's 'Sections' header opened a blank page (e.g. /enterprise-rollout/00-overview/). The flat sections (guides, internals, perspectives) were unaffected because they have body content and no nested subsections. Give each subsection index a landing body: a heading, the one-line description already used on the parent page, and weight-ordered relref links to its child articles. Strict relref resolves all links at build.
Contributor
There was a problem hiding this comment.
Pull request overview
This PR fixes blank landing pages for the nested enterprise-rollout/ subsections in the Hugo Book theme by adding body content to each subsection _index.md, so the main pane renders meaningful content instead of an empty page.
Changes:
- Added an
H1+ short section summary to eachenterprise-rollout/*/_index.mdsubsection landing page. - Added weight-ordered child-article link lists using
{{< relref ... >}}to ensure build-checked navigation from each landing page.
Reviewed changes
Copilot reviewed 8 out of 8 changed files in this pull request and generated no comments.
Show a summary per file
| File | Description |
|---|---|
| content/enterprise-rollout/00-overview/_index.md | Adds landing content and relref links to Overview child pages. |
| content/enterprise-rollout/01-skill-gaps-and-market-opportunity/_index.md | Adds landing content and relref links to section child pages. |
| content/enterprise-rollout/02-phase-0-infrastructure-foundation/_index.md | Adds landing content and relref links to Phase 0 child pages. |
| content/enterprise-rollout/03-phase-1-platform-engineering/_index.md | Adds landing content and relref links to Phase 1 child pages. |
| content/enterprise-rollout/04-phase-2-phased-rollout/_index.md | Adds landing content and relref link to Phase 2 child page. |
| content/enterprise-rollout/05-phase-3-observability-and-governance/_index.md | Adds landing content and relref links to Phase 3 child pages. |
| content/enterprise-rollout/06-implementation-support-ecosystem/_index.md | Adds landing content and relref links to section child pages. |
| content/enterprise-rollout/appendix/_index.md | Adds landing content and relref links to Appendix child pages. |
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.
Problem
Every link under the Sections header on the Enterprise Claude Code Rollout landing page opened a blank page (reported for
/enterprise-rollout/00-overview/, but all eight were affected).Root cause
The 8 subsection
_index.mdfiles undercontent/enterprise-rollout/contained only YAML front matter and no body. The Hugo Book theme renders the_indexbody in the main pane, so an empty body produces a blank page. The flat sections (guides, internals, perspectives) were unaffected -- they have body content and no nested subsections, so they were never exercised this way.Fix
Give each subsection index a landing body:
H1matching the section title.relrefshortcodes (matches the parent page's link style and is build-checked).No
---horizontal-rule dividers in the new content, per STYLE-GUIDE.md.Verification
hugo --gc --minifybuilds clean (106 pages). Strictrelrefresolves every link -- a broken ref would fail the build.00-overview/index.htmlhas all four (executive-summary, architecture-overview, roi-framework, three-year-npv-worksheet);appendix/index.htmlhas its three.Note
The parent
enterprise-rollout/_index.mduses---dividers (pre-existing style-guide deviation) -- left untouched as out of scope for this fix.