Skip to content

Update Cloud Engineering page #15252

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
wants to merge 9 commits into
base: master
Choose a base branch
from

Conversation

asafashirov
Copy link
Contributor

@asafashirov asafashirov commented Jun 6, 2025

Summary

  • Transform hero to 'Modern Infrastructure Platform for the AI Era' positioning
  • Add Strategic Business Value section with 224% ROI, 25% faster time-to-market, and measurable outcomes
  • Enhance Build/Deploy/Scale sections with AI-powered Copilot integration and unified platform story
  • Add competitive differentiation section comparing modern vs legacy infrastructure approaches
  • Include gradual modernization pathways (Greenfield + Coexistence, Enhanced Governance, Platform Transformation)
  • Update benefits with strategic messaging focusing on Innovation Velocity, Risk Reduction, Cost Optimization, and Operational Excellence
  • Enhance customer testimonials with strategic context for better prospect identification

Key Changes from Previous Framework

  • Elevate from tactical cloud engineering to strategic Modern Infrastructure Platform positioning
  • Integrate AI-powered capabilities throughout (Pulumi Copilot)
  • Add comprehensive competitive messaging against legacy tools
  • Include flexible adoption pathways for different organizational readiness levels
  • Transform benefits from technical metrics to business outcome focus

Test plan

  • Verify meta description meets 160 character limit requirement
  • Confirm all markdown linting passes
  • Validate content structure maintains existing page flow
  • Review page rendering in staging environment
  • Validate business metrics align with framework documentation
  • Test engagement with new strategic positioning content

…ing page

- Add business impact metrics to hero section (50% faster deployment cycles, $3-4.5M annual productivity value, 85% reduction in security incidents)
- Introduce new Discover section with infrastructure visibility content before Build section
- Transform Manage section to Scale with platform scalability messaging
- Add maturity stage callout box with Automate/Secure/Manage progression
- Update benefits section with specific validated metrics instead of generic statements
- Include implementation pathway with structured Getting Started guidance
- Add framework stage context to customer testimonials

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
@asafashirov asafashirov force-pushed the cloud-engineering-framework-update branch from 838dc4d to a0ec53d Compare June 6, 2025 15:47
@pulumi-bot
Copy link
Collaborator

@pulumi-bot
Copy link
Collaborator

…itioning

- Transform hero to 'Modern Infrastructure Platform for the AI Era'
- Add Strategic Business Value section with 224% ROI metrics
- Enhance sections with AI-powered Copilot and unified platform story
- Add competitive differentiation (modern vs legacy infrastructure)
- Include gradual modernization pathways
- Update benefits with strategic messaging and new metrics
- Enhance customer testimonials with strategic context
- Replace 'savings' icon with 'exchange' for cost optimization sections
- Replace 'trending-up' icon with 'guage' for ROI metrics
- Ensures all icons exist in the icon system
- Replace 'users' icon with 'team' icon in both strategic business value and benefits sections
- Ensures all icon references point to existing icons in the system
@pulumi-bot
Copy link
Collaborator

- Update all metrics to multiplier format (2-3x ROI, 2x reduction, 3x optimization, 4x efficiency)
- Restructure Strategic Advantages section for better scannability with subtitles and bold formatting
- Add platform outcomes transition section to improve flow from Scale to Strategic Advantages
- Make benefit descriptions more scannable with bold key phrases and shorter bullet points
@pulumi-bot
Copy link
Collaborator

@asafashirov asafashirov requested a review from scottmparker June 13, 2025 20:04
@scottmparker scottmparker changed the title Implement Discover-Build-Scale messaging framework for Cloud Engineering page Update Cloud Engineering page Jun 13, 2025
@scottmparker
Copy link

Found a few formatting and consistency issues that should be addressed:

Formatting Issues:

  • Markdown formatting is visible in the "Strategic Advantages" section (double asterisks showing instead of bold text)
  • The section appears to have broken formatting, making bullet points hard to scan

Metric Consistency:

  • "74% reduction in management overhead" in Scale section → should be "4x reduction in management overhead"
  • "reduces errors by 85%" in the Advanced Testing section → consider "6x error reduction"
  • "20-40% cost optimization opportunities" → consider "2-4x cost optimization opportunities"

Overall Assessment:

Strong implementation of the strategic messaging framework. The ROI positioning, AI integration, and platform story work well together. These are quick fixes for consistency and formatting before production deployment.

Status: Ready to ship once these items are addressed.

@pulumi-bot
Copy link
Collaborator

- Change '74% reduction in management overhead' to '4x reduction in management overhead'
- Change 'reduces errors by 85%' to '6x error reduction'
- Change '20-40% cost optimization opportunities' to '2-4x cost optimization opportunities'

All metrics now use consistent multiplier format as requested.
@asafashirov
Copy link
Contributor Author

@scottmparker I've addressed your feedback - please review/approve at your convenience.

@pulumi-bot
Copy link
Collaborator

@pulumi-bot
Copy link
Collaborator

@scottmparker
Copy link

@asafashirov, the preview directs me to a version of the Pulumi home page, not the Cloud Engineering page. Am I doing something wrong?

@asafashirov
Copy link
Contributor Author

@scottmparker for whatever reason all of our previews direct to the homepage from which you have to navigate to the updated page yourself; here it is: http://www-testing-pulumi-docs-origin-pr-15252-7513181f.s3-website.us-west-2.amazonaws.com/cloud-engineering/

@scottmparker
Copy link

Okay, thanks for clarifying.

I'm still seeing Markdown in the preview - i.e., double asterisks showing instead of bold text.

- Remove double asterisks (**) causing markdown formatting issues
- Add missing sections to cloud-engineering.html template:
  - maturity_stages
  - strategic_business_value
  - discover
  - platform_outcomes
  - competitive_differentiation
  - implementation_pathway
  - modernization_pathways

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
@pulumi-bot
Copy link
Collaborator

- Fix typo: "guage" → "gauge" icon name
- Center best practices section by removing empty left column
- Integrate platform outcomes as intro to competitive differentiation
- Improve responsive grid layouts for better mobile/tablet experience
- Standardize section spacing for consistent visual hierarchy

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
The icon file is actually named "guage" (with typo) in the codebase,
so reverting the "fix" that was causing build failures.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
@pulumi-bot
Copy link
Collaborator

@asafashirov asafashirov marked this pull request as draft June 16, 2025 21:44
@asafashirov
Copy link
Contributor Author

@scottmparker not sure what's going on there; I removed all the asterisks.

I also noticed many of the sections were missing from the preview render due to some missing elements in the template that I addressed in the latest commit: http://www-testing-pulumi-docs-origin-pr-15252-e1afc3fe.s3-website.us-west-2.amazonaws.com/cloud-engineering/

Regardless, I don't think it's ready to be published as it needs some styling/layout updates. I'll reach out to UX for help. Let me know if you have any more feedback with regard to content. Thanks!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants