Skip to content

Conversation

asafashirov
Copy link
Contributor

@asafashirov asafashirov commented Sep 2, 2025

Overview

This PR improves the website navigation and creates a new language-first getting started experience, following a similar approach to Heroku's developer center.

Changes

Navigation & Layout Updates

  • Moved secondary navigation (GitHub stars, Slack, Docs links) from header to footer
  • Reordered main navigation with 'Learn' as the first item
  • Removed 'Company' dropdown from main navigation (moved to footer)
  • Changed header CTA from 'Sign up' to 'START HERE' pointing to /start-now
  • Fixed Learn dropdown positioning when it appears as first navigation item

New Getting Started Experience (/start-now)

  • Created new /start-now page with language-first approach (will change to /start if published)
  • Modeled after Heroku's approach: https://devcenter.heroku.com/start
  • Language selection with 6 options: TypeScript, Python, Go, C#, Java, YAML
  • Clean 2x3 grid layout for language selectors
  • Created individual language pages (e.g., /start-now/typescript) that guide users to cloud-specific documentation
  • Each language page includes cloud provider selection, quick setup steps, and resources

Footer Reorganization

  • Added new 'Developer Tools' section with GitHub, Slack, Registry, Pulumi AI, Security, Contact Us
  • Ensured complete Company section with all relevant links

- Simplify header by removing secondary navigation bar
- Reorder main navigation with Learn as first item
- Move Company section from main nav to footer
- Update CTAs to point to new /start-now page
- Create comprehensive /start-now hub with cloud and language options
- Add AWS TypeScript getting started guide with hands-on tutorial
- Reorganize footer with Developer Tools section
- Simplified structure with two primary paths (Quick Start and Terraform migration)
- Added language-first selection following Heroku's proven model
- Created language-specific pages linking to appropriate cloud providers
- Removed complex cloud × language matrix
- Better progressive disclosure of options
- Reuses existing comprehensive documentation
- Remove duplicate H1 headings (title already in frontmatter)
- Remove extra blank lines at end of files
- Fix C# heading style to use atx_closed format
@pulumi-bot
Copy link
Collaborator

- Remove invalid layout references from all /start-now pages
- Remove duplicate H1 from main /start-now page
- Add CSS fix for Learn dropdown positioning when it's the first nav item
@pulumi-bot
Copy link
Collaborator

- Created layouts/page/start-now.html for main start page layout
- Created layouts/page/language-start.html for language-specific pages
- Converted all content files from raw HTML to structured YAML frontmatter
- Removed raw HTML in favor of Hugo templates using marketing.css classes
- Fixed rendering issues by using proper template structure
- All 7 pages now use consistent layouts and styling patterns

This follows the same pattern as other marketing pages like /product and /pricing

🤖 Generated with Claude Code

Co-Authored-By: Claude <[email protected]>
asafashirov and others added 2 commits September 3, 2025 09:29
Add required single newline at end of all language-specific start-now pages

🤖 Generated with Claude Code

Co-Authored-By: Claude <[email protected]>
Add required single newline at end of all language-specific start-now pages

🤖 Generated with Claude Code

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

- Changed title to 'Getting Started with Pulumi'
- Updated subtitle to focus on step-by-step guides
- Removed Quick Start and Terraform migration sections
- Changed language section title to 'Start by Selecting Your Favorite Language'
- Removed Popular Templates section
- Simplified layout template to match content changes

This creates a cleaner, more focused language-first getting started experience
@pulumi-bot
Copy link
Collaborator

asafashirov and others added 4 commits September 3, 2025 13:12
- Changed language selectors to 2x3 grid layout (3 per row)
- Made 'Getting Started with Pulumi' title smaller (h2 instead of h1)
- Removed language section headings for cleaner look
- Added more padding between subtitle and language cards
- Restored Neo announcement banner at top of page
- Adjusted max-width for language grid to better accommodate 3 columns

🤖 Generated with Claude Code

Co-Authored-By: Claude <[email protected]>
- Wrapped banner partial in proper nav structure
- Added top-nav-bar and top-nav-container classes
- This ensures banner CSS styles are properly applied
- Banner now displays with gradient border as intended

🤖 Generated with Claude Code

Co-Authored-By: Claude <[email protected]>
- Changed main title from h1 to h2 with same size as /start-now page
- Removed 'Why...?' and 'Example' sections from all language pages
- Pages now focus only on cloud provider selection, quick setup, and resources
- Cleaner, more streamlined experience for users

🤖 Generated with Claude Code

Co-Authored-By: Claude <[email protected]>
- Changed main nav CTA from 'Sign up' to 'START HERE'
- Updated CTA link to point to /start-now page
- Fixed banner width to respect container margins
- Banner now aligns with main navigation container
@pulumi-bot
Copy link
Collaborator

- Updated mobile menu button to 'START HERE' linking to /start-now
- Rebuilt theme assets to apply StencilJS component changes
- Desktop and mobile CTAs now consistently show 'START HERE'
@pulumi-bot
Copy link
Collaborator

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.

2 participants