Skip to content

(Draft) Add md files next to html files #15443

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 12 commits into
base: master
Choose a base branch
from
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 20 additions & 0 deletions config/_default/config.yml
Original file line number Diff line number Diff line change
Expand Up @@ -33,6 +33,22 @@ timeout: 300000
outputFormats:
rss:
baseName: rss
llmmd:
mediaType: "text/markdown"
isPlainText: true
notAlternative: false
permalinkable: false
path: ""
rel: "llmmd"
suffix: ".md"
txt:
mediaType: "text/plain"
isPlainText: true
notAlternative: false
permalinkable: false
path: ""
rel: "txt"
suffix: ".txt"

# We set the outputs explicitly to just "HTML" as otherwise they default to both
# "HTML" and "RSS", and we only want to generate RSS for the blog section -- not
Expand All @@ -45,6 +61,10 @@ outputs:
- JSON
section:
- HTML
- llmmd
page:
- HTML
- llmmd

taxonomies:
tag: tags
Expand Down
10 changes: 5 additions & 5 deletions content/docs/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -62,16 +62,16 @@ sections:
cards:
- label: AWS & Pulumi
icon: aws-40
link: /docs/clouds/aws/
link: /docs/iac/clouds/aws/
- label: Azure & Pulumi
icon: azure-40
link: /docs/clouds/azure/
link: /docs/iac/clouds/azure/
- label: Google Cloud & Pulumi
icon: google-cloud-40
link: /docs/clouds/gcp/
link: /docs/iac/clouds/gcp/
- label: Kubernetes & Pulumi
icon: kubernetes-40
link: /docs/clouds/kubernetes/
link: /docs/iac/clouds/kubernetes/
- type: blue-sparkle
heading: Why Pulumi?
description: |
Expand Down Expand Up @@ -125,6 +125,6 @@ sections:
- type: flat
heading: Enterprise and Business Critical support
description: |
<p>Pulumi provides a range of support options such as dedicated 24x7 support, premium training, onboarding, and professional services. Please see our <a href="https://www.pulumi.com/pricing/">pricing page</a> for the support options available. To open a support ticket or view service status, please visit our <a href="https://support.pulumi.com/hc/en-us">enterprise support portal</a>.</p>
<p>Pulumi provides a range of support options such as dedicated 24x7 support, premium training, onboarding, and professional services. Please see our <a href="/pricing/">pricing page</a> for the support options available. To open a support ticket or view service status, please visit our <a href="https://support.pulumi.com/hc/en-us">enterprise support portal</a>.</p>

---
2 changes: 1 addition & 1 deletion content/docs/esc/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -110,7 +110,7 @@ sections:
- icon: lightbulb-blue-21-21
heading: Detailed overview of environments
description: Learn more about managing environments using Pulumi ESC.
link: /docs/pulumi-cloud/esc/environments/
link: /docs/esc/environments/working-with-environments/
- icon: terminal-blue-21-21
heading: Integration with Docker
description: Pulumi ESC integrates with Docker to manage configuration and secrets while running docker commands.
Expand Down
24 changes: 12 additions & 12 deletions content/docs/iac/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,38 +28,38 @@ sections:
cards:
- label: AWS & Pulumi
icon: aws-40
link: /docs/clouds/aws/
link: /docs/iac/clouds/aws/
- label: Azure & Pulumi
icon: azure-40
link: /docs/clouds/azure/
link: /docs/iac/clouds/azure/
- label: Google Cloud & Pulumi
icon: google-cloud-40
link: /docs/clouds/gcp/
link: /docs/iac/clouds/gcp/
- label: Kubernetes & Pulumi
icon: kubernetes-40
link: /docs/clouds/kubernetes/
link: /docs/iac/clouds/kubernetes/
- type: cards-logo-label-link
heading: Languages
description: Build infrastructure intuitively on any cloud using familiar languages.
cards:
- label: Node.js
icon: icon-32-32 node-color-32-32
link: /docs/languages-sdks/javascript/
link: /docs/iac/languages-sdks/javascript/
- label: Python
icon: icon-32-32 python-color-32-32
link: /docs/languages-sdks/python/
link: /docs/iac/languages-sdks/python/
- label: Go
icon: icon-32-32 go-color-32-32
link: /docs/languages-sdks/go/
link: /docs/iac/languages-sdks/go/
- label: .NET
icon: icon-32-32 dotnet-color-32-32
link: /docs/languages-sdks/dotnet/
link: /docs/iac/languages-sdks/dotnet/
- label: Java
icon: icon-32-32 java-color-32-32
link: /docs/languages-sdks/java/
link: /docs/iac/languages-sdks/java/
- label: YAML
icon: icon-32-32 yaml-color-32-32
link: /docs/languages-sdks/yaml/
link: /docs/iac/languages-sdks/yaml/
- type: full-width-cards
heading: Featured docs
cards:
Expand All @@ -70,11 +70,11 @@ sections:
- icon: terminal-blue-21-21
heading: Pulumi CLI
description: Browse the complete documentation of available CLI commands.
link: /docs/cli/
link: /docs/iac/cli/
- icon: swap-blue-21-21
heading: Adopting Pulumi
description: Migrate any infrastructure to Pulumi with comprehensive guides.
link: /docs/using-pulumi/adopting-pulumi/
link: /docs/iac/adopting-pulumi/
- type: blue-sparkle
heading: Why Pulumi IaC?
description: Pulumi IaC enables developers to deploy infrastructure in any cloud environment with one common approach. Leverage familiar languages to make the most of abstractions and reuse while enjoying access in your favorite IDEs, and testing tools!
Expand Down
2 changes: 1 addition & 1 deletion content/docs/pulumi-cloud/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,7 @@ sections:
secondary_button_link: /docs/pulumi-cloud/copilot/#frequently-asked-questions
- heading: Pulumi CrossGuard
description: Enforce guardrails for security and compliance using policies in standard languages
link: /docs/iac/packages-and-automation/crossguard/
link: /docs/iac/crossguard/faq/
primary_button_label: Get Started
primary_button_link: /docs/iac/packages-and-automation/crossguard/get-started/
secondary_button_label: Learn More
Expand Down
9 changes: 9 additions & 0 deletions content/llms.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
---
title: "llms.txt"
meta_desc: "LLM-friendly overview of Pulumi documentation structure and key resources for AI systems to understand infrastructure as code concepts and tools."
url: "/llms.txt"
outputs:
- "txt"
_build:
list: never
---
41 changes: 41 additions & 0 deletions layouts/_default/list.llmmd.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
# {{ .Title }}

{{ with .Params.meta_desc }}
> {{ . }}
{{ end }}

{{ range .Params.sections }}
## {{ .heading }}

{{ with or .description .description_md }}
{{ $find := `href="(/[^"h][^"t][^"t][^"p][^"s][^:#]*/)"` }}
{{ $replace := `href="${1}index.md"` }}
{{ . | replaceRE $find $replace | markdownify }}
{{ end }}

{{- if .cards }}
{{ range .cards }}
{{- if or .heading .label }}
### {{ or .heading .label }}
{{- end }}

{{ with .description }}
{{ . }}
{{ end }}

{{ with .link }}
{{ if hasPrefix . "http" }}
[Read more]({{ . }})
{{ else }}
[Read more]({{ . | relURL }}index.md)
{{ end }}
{{ end }}

{{ end }}
{{ end }}

{{- end }}

{{- if .Content }}
{{ .Content }}
{{- end }}
3 changes: 3 additions & 0 deletions layouts/_default/single.llmmd.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# {{ .Title }}

{{- .RawContent -}}
61 changes: 61 additions & 0 deletions layouts/_default/single.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,61 @@
# Pulumi

> Modern Infrastructure as Code platform that lets you use real programming languages to build and deploy cloud infrastructure across any cloud provider.

Pulumi is the universal infrastructure as code platform that enables developers, platform teams, and enterprises to build, deploy, and manage cloud infrastructure using familiar programming languages. Unlike traditional Infrastructure as Code tools that use domain-specific languages, Pulumi supports TypeScript, Python, Go, .NET, Java, and YAML.

## Key Products

- [Infrastructure as Code (IaC)]({{ .Site.BaseURL }}docs/iac/index.md): Build cloud infrastructure using real programming languages
- [Pulumi ESC (Environments, Secrets, and Configuration)]({{ .Site.BaseURL }}docs/esc/index.md): Centralized secrets and configuration management
- [Pulumi Cloud]({{ .Site.BaseURL }}docs/pulumi-cloud/index.md): Managed service for teams with collaboration, security, and deployment features
- [Pulumi Insights]({{ .Site.BaseURL }}docs/insights/index.md): AI-powered cloud resource discovery and compliance
- [CrossGuard]({{ .Site.BaseURL }}docs/iac/crossguard/index.md): Policy as code for infrastructure compliance and governance

## Pricing

- [View Pricing]({{ .Site.BaseURL }}pricing/index.md): Plans and pricing for Pulumi products

## Getting Started

- [Install Pulumi]({{ .Site.BaseURL }}docs/iac/download-install/index.md): Installation instructions for all platforms
- [Get Started with AWS]({{ .Site.BaseURL }}docs/iac/get-started/aws/index.md): Build your first AWS infrastructure
- [Get Started with Azure]({{ .Site.BaseURL }}docs/iac/get-started/azure/index.md): Build your first Azure infrastructure
- [Get Started with Google Cloud]({{ .Site.BaseURL }}docs/iac/get-started/gcp/index.md): Build your first GCP infrastructure
- [Get Started with Kubernetes]({{ .Site.BaseURL }}docs/iac/get-started/kubernetes/index.md): Deploy Kubernetes resources

## Language Support

- [TypeScript/JavaScript]({{ .Site.BaseURL }}docs/iac/languages-sdks/javascript/index.md): Most popular language for Pulumi
- [Python]({{ .Site.BaseURL }}docs/iac/languages-sdks/python/index.md): Full Python SDK with async support
- [Go]({{ .Site.BaseURL }}docs/iac/languages-sdks/go/index.md): Native Go SDK for infrastructure
- [.NET]({{ .Site.BaseURL }}docs/iac/languages-sdks/dotnet/index.md): C#, F#, and VB.NET support
- [Java]({{ .Site.BaseURL }}docs/iac/languages-sdks/java/index.md): Full Java SDK support
- [YAML]({{ .Site.BaseURL }}docs/iac/languages-sdks/yaml/index.md): Declarative YAML-based infrastructure

## Core Resources

- [Programming Model]({{ .Site.BaseURL }}docs/reference/programming-model/index.md): Understanding resources, inputs, outputs, and state
- [Stacks and Projects]({{ .Site.BaseURL }}docs/iac/concepts/organizing-stacks-projects/index.md): Organizing infrastructure code
- [Secrets Management]({{ .Site.BaseURL }}docs/iac/concepts/secrets/index.md): Handling sensitive configuration data
- [Testing Infrastructure]({{ .Site.BaseURL }}docs/iac/concepts/testing/index.md): Unit and integration testing approaches
- [Continuous Delivery]({{ .Site.BaseURL }}docs/iac/using-pulumi/continuous-delivery/index.md): CI/CD integration patterns

## Migration and Adoption

- [Import Existing Infrastructure]({{ .Site.BaseURL }}docs/iac/adopting-pulumi/import/index.md): Import cloud resources into Pulumi
- [Convert from Terraform]({{ .Site.BaseURL }}docs/iac/adopting-pulumi/migrating-to-pulumi/from-terraform/index.md): Migration guide from Terraform
- [Convert from CloudFormation]({{ .Site.BaseURL }}docs/iac/adopting-pulumi/migrating-to-pulumi/from-cloudformation/index.md): Migration from AWS CloudFormation
- [Conversion Tools]({{ .Site.BaseURL }}docs/iac/adopting-pulumi/converters/index.md): Automated conversion utilities

## CLI Reference

- [Pulumi CLI Commands]({{ .Site.BaseURL }}docs/iac/cli/commands/index.md): Complete command reference
- [Environment Variables]({{ .Site.BaseURL }}docs/iac/cli/environment-variables/index.md): Configuration options
- [ESC CLI Commands]({{ .Site.BaseURL }}docs/esc/cli/commands/index.md): Pulumi ESC command reference

## API and SDKs

- [Automation API]({{ .Site.BaseURL }}docs/iac/automation-api/index.md): Programmatic infrastructure management
- [Provider SDK]({{ .Site.BaseURL }}docs/iac/extending-pulumi/pulumi-provider-sdk/index.md): Building custom providers
- [Package Publishing]({{ .Site.BaseURL }}docs/iac/extending-pulumi/publishing-packages/index.md): Sharing reusable components
55 changes: 55 additions & 0 deletions layouts/page/pricing.llmmd.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,55 @@
# {{ .Title }}

{{ with .Params.meta_desc }}
{{ . }}
{{ end }}

## Pricing Plans

{{ range .Params.tiers.trialed.items }}
### {{ .title }}
{{ .subtitle }}

**Pulumi IaC:** {{ .iac_price }}{{ if .iac_unit }} {{ .iac_unit }}{{ end }}{{ if .iac_note }} ({{ .iac_note }}){{ end }}
{{ if .esc_price }}**Pulumi ESC:** {{ .esc_price }}{{ if .esc_unit }} {{ .esc_unit }}{{ end }}{{ if .esc_note }} ({{ .esc_note }}){{ end }}{{ end }}
{{ if .insights_price }}**Pulumi Insights:** {{ .insights_price }}{{ if .insights_unit }} {{ .insights_unit }}{{ end }}{{ if .insights_note }} ({{ .insights_note }}){{ end }}{{ end }}

{{ .items }}

{{ end }}

## Feature Comparison

{{ range .Params.comparison_table.sections }}
### {{ .header }}

{{ range .tables }}
#### {{ .header }}
{{ with .subheader }}{{ . }}{{ end }}

| Feature | Free | Team | Enterprise | Business Critical |
|---------|------|------|------------|-------------------|
{{ range .rows }}| {{ .title }} | {{ range $index, $item := .items }}{{ if eq $item.content "_check" }}✓{{ else if eq $item.content "_blank" }}—{{ else }}{{ $item.content | markdownify | plainify }}{{ end }}{{ if ne $index 3 }} | {{ end }}{{ end }} |
{{ end }}

{{ end }}
{{ end }}

## Customer Success Stories

{{ range .Params.customers }}
- {{ .stat | markdownify | plainify }}
{{ end }}

## Frequently Asked Questions

{{ range .Params.faq }}
### {{ .category }}

{{ range .items }}
**{{ .question }}**

{{ .answer }}

{{ end }}
{{ end }}
Loading