From ea6c215043cf92a74d4e247907eeaeb862c25356 Mon Sep 17 00:00:00 2001 From: Mark Alston Date: Mon, 29 Jun 2026 16:13:11 -0600 Subject: [PATCH] Fix blank enterprise-rollout section landing pages 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. --- content/enterprise-rollout/00-overview/_index.md | 9 +++++++++ .../01-skill-gaps-and-market-opportunity/_index.md | 7 +++++++ .../02-phase-0-infrastructure-foundation/_index.md | 11 +++++++++++ .../03-phase-1-platform-engineering/_index.md | 13 +++++++++++++ .../04-phase-2-phased-rollout/_index.md | 6 ++++++ .../_index.md | 8 ++++++++ .../06-implementation-support-ecosystem/_index.md | 7 +++++++ content/enterprise-rollout/appendix/_index.md | 8 ++++++++ 8 files changed, 69 insertions(+) diff --git a/content/enterprise-rollout/00-overview/_index.md b/content/enterprise-rollout/00-overview/_index.md index 7a59dc4..f7cc0e1 100644 --- a/content/enterprise-rollout/00-overview/_index.md +++ b/content/enterprise-rollout/00-overview/_index.md @@ -3,3 +3,12 @@ title: "Overview" weight: 1 bookCollapseSection: false --- + +# Overview + +Executive summary, architecture overview, and the financial case for stakeholder alignment. + +- **[Executive Summary]({{< relref "enterprise-rollout/00-overview/executive-summary" >}})** +- **[Architecture Overview]({{< relref "enterprise-rollout/00-overview/architecture-overview" >}})** +- **[ROI Framework]({{< relref "enterprise-rollout/00-overview/roi-framework" >}})** +- **[Three-Year NPV Worksheet]({{< relref "enterprise-rollout/00-overview/three-year-npv-worksheet" >}})** diff --git a/content/enterprise-rollout/01-skill-gaps-and-market-opportunity/_index.md b/content/enterprise-rollout/01-skill-gaps-and-market-opportunity/_index.md index 3750a1a..21141b4 100644 --- a/content/enterprise-rollout/01-skill-gaps-and-market-opportunity/_index.md +++ b/content/enterprise-rollout/01-skill-gaps-and-market-opportunity/_index.md @@ -3,3 +3,10 @@ title: "Skill Gaps and Market Opportunity" weight: 2 bookCollapseSection: false --- + +# Skill Gaps and Market Opportunity + +Where developer teams struggle today and the consulting engagement opportunity. + +- **[Enterprise Claude Code Adoption -- Skill Gaps]({{< relref "enterprise-rollout/01-skill-gaps-and-market-opportunity/skill-gaps" >}})** +- **[Market Opportunity Analysis]({{< relref "enterprise-rollout/01-skill-gaps-and-market-opportunity/market-opportunity" >}})** diff --git a/content/enterprise-rollout/02-phase-0-infrastructure-foundation/_index.md b/content/enterprise-rollout/02-phase-0-infrastructure-foundation/_index.md index 93e5a3a..22c55dd 100644 --- a/content/enterprise-rollout/02-phase-0-infrastructure-foundation/_index.md +++ b/content/enterprise-rollout/02-phase-0-infrastructure-foundation/_index.md @@ -3,3 +3,14 @@ title: "Phase 0: Infrastructure Foundation" weight: 3 bookCollapseSection: false --- + +# Phase 0: Infrastructure Foundation + +Weeks 1--4. Stand up cloud provider infrastructure (Bedrock, Vertex AI, or Foundry) with private networking so all LLM traffic stays inside the customer's network. + +- **[Amazon Bedrock Fundamentals]({{< relref "enterprise-rollout/02-phase-0-infrastructure-foundation/bedrock-fundamentals" >}})** +- **[Google Vertex AI Fundamentals]({{< relref "enterprise-rollout/02-phase-0-infrastructure-foundation/vertex-fundamentals" >}})** +- **[Azure Foundry Fundamentals]({{< relref "enterprise-rollout/02-phase-0-infrastructure-foundation/foundry-fundamentals" >}})** +- **[VPC Endpoint and PrivateLink Architecture]({{< relref "enterprise-rollout/02-phase-0-infrastructure-foundation/vpc-privatelink" >}})** +- **[LLM Gateway Design]({{< relref "enterprise-rollout/02-phase-0-infrastructure-foundation/llm-gateway" >}})** +- **[Security Constraint Clarification]({{< relref "enterprise-rollout/02-phase-0-infrastructure-foundation/security-constraint-clarification" >}})** diff --git a/content/enterprise-rollout/03-phase-1-platform-engineering/_index.md b/content/enterprise-rollout/03-phase-1-platform-engineering/_index.md index 88db89f..8185803 100644 --- a/content/enterprise-rollout/03-phase-1-platform-engineering/_index.md +++ b/content/enterprise-rollout/03-phase-1-platform-engineering/_index.md @@ -3,3 +3,16 @@ title: "Phase 1: Platform Engineering" weight: 4 bookCollapseSection: false --- + +# Phase 1: Platform Engineering + +Weeks 3--6. Configure managed settings, CLAUDE.md architecture, skills libraries, and developer environment standardization. + +- **[Managed Settings and Security Policy]({{< relref "enterprise-rollout/03-phase-1-platform-engineering/managed-settings" >}})** +- **[Developer Environment Standardization]({{< relref "enterprise-rollout/03-phase-1-platform-engineering/developer-environment" >}})** +- **[CLAUDE.md Architecture -- Four-Layer Context Hierarchy]({{< relref "enterprise-rollout/03-phase-1-platform-engineering/claude-md-architecture" >}})** +- **[Skills vs. Slash Commands vs. Rules -- Decision Framework]({{< relref "enterprise-rollout/03-phase-1-platform-engineering/skills-commands-rules-decision-framework" >}})** +- **[Skills Library Design -- Three-Tier Architecture]({{< relref "enterprise-rollout/03-phase-1-platform-engineering/skills-library-design" >}})** +- **[Context Budget Worksheet]({{< relref "enterprise-rollout/03-phase-1-platform-engineering/context-budget-worksheet" >}})** +- **[Common Failure Modes]({{< relref "enterprise-rollout/03-phase-1-platform-engineering/failure-modes" >}})** +- **[What Developers See]({{< relref "enterprise-rollout/03-phase-1-platform-engineering/what-developers-see" >}})** diff --git a/content/enterprise-rollout/04-phase-2-phased-rollout/_index.md b/content/enterprise-rollout/04-phase-2-phased-rollout/_index.md index 1943fa0..2d968b3 100644 --- a/content/enterprise-rollout/04-phase-2-phased-rollout/_index.md +++ b/content/enterprise-rollout/04-phase-2-phased-rollout/_index.md @@ -3,3 +3,9 @@ title: "Phase 2: Phased Rollout" weight: 5 bookCollapseSection: false --- + +# Phase 2: Phased Rollout + +Weeks 5--12. Three cohorts of increasing size, each with a learning loop from platform engineers through early adopters to general availability. + +- **[Phased Rollout -- Cohort Strategy]({{< relref "enterprise-rollout/04-phase-2-phased-rollout/cohort-strategy" >}})** diff --git a/content/enterprise-rollout/05-phase-3-observability-and-governance/_index.md b/content/enterprise-rollout/05-phase-3-observability-and-governance/_index.md index aac7733..4cea4b0 100644 --- a/content/enterprise-rollout/05-phase-3-observability-and-governance/_index.md +++ b/content/enterprise-rollout/05-phase-3-observability-and-governance/_index.md @@ -3,3 +3,11 @@ title: "Phase 3: Observability and Governance" weight: 6 bookCollapseSection: false --- + +# Phase 3: Observability and Governance + +Ongoing. Cost tracking with token budgets, three-layer audit architecture, and security controls. + +- **[Audit and Compliance -- Three-Layer Architecture]({{< relref "enterprise-rollout/05-phase-3-observability-and-governance/audit-compliance" >}})** +- **[Cost Tracking and Budgets]({{< relref "enterprise-rollout/05-phase-3-observability-and-governance/cost-tracking" >}})** +- **[Security Controls]({{< relref "enterprise-rollout/05-phase-3-observability-and-governance/security-controls" >}})** diff --git a/content/enterprise-rollout/06-implementation-support-ecosystem/_index.md b/content/enterprise-rollout/06-implementation-support-ecosystem/_index.md index f4d0da8..82bb358 100644 --- a/content/enterprise-rollout/06-implementation-support-ecosystem/_index.md +++ b/content/enterprise-rollout/06-implementation-support-ecosystem/_index.md @@ -3,3 +3,10 @@ title: "Implementation Support Ecosystem" weight: 7 bookCollapseSection: false --- + +# Implementation Support Ecosystem + +Support landscape and recommendations for handling organizational pushback. + +- **[Implementation Support Landscape]({{< relref "enterprise-rollout/06-implementation-support-ecosystem/support-landscape" >}})** +- **[Common Customer Requests -- Pushback Recommendations]({{< relref "enterprise-rollout/06-implementation-support-ecosystem/pushback-recommendations" >}})** diff --git a/content/enterprise-rollout/appendix/_index.md b/content/enterprise-rollout/appendix/_index.md index e3cf943..c9b423c 100644 --- a/content/enterprise-rollout/appendix/_index.md +++ b/content/enterprise-rollout/appendix/_index.md @@ -3,3 +3,11 @@ title: "Appendix" weight: 8 bookCollapseSection: false --- + +# Appendix + +Build-out timeline, Cloud Foundry analogy map, and reference configurations. + +- **[Build-Out Timeline -- 12-Week Implementation]({{< relref "enterprise-rollout/appendix/build-out-timeline" >}})** +- **[Cloud Foundry to Claude Code Analogy Map]({{< relref "enterprise-rollout/appendix/cf-analogy-map" >}})** +- **[Reference Configurations]({{< relref "enterprise-rollout/appendix/reference-configs" >}})**