diff --git a/AGENTS.md b/AGENTS.md index 1b6230275a98..7b052a4d890d 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -10,26 +10,6 @@ This repository contains the source for the Pulumi website, built with [Hugo](ht --- -## AI Assistant Information (llms.txt) - -This repository implements the llms.txt standard for improved AI/LLM consumption: - -- **Primary content index**: https://www.pulumi.com/llms.txt -- **Standard**: Following [llms.txt specification](https://llmstxt.org/) -- **Content structure**: Hierarchical documentation index optimized for LLM context windows -- **Focus areas for AI consumption**: - - `/docs/iac/` - Infrastructure as Code documentation - - `/docs/esc/` - Secrets and configuration management - - `/docs/pulumi-cloud/` - Platform capabilities - - `/registry/` - Provider and package documentation - - `/docs/reference/` - API references for all languages -- **Markdown versions**: Future enhancement - URLs may support `.md` extension for markdown-only output -- **Excluding content from llms.txt**: Add `llms_exclude: true` to front matter - -When working with Pulumi documentation, consult the llms.txt file first for structured navigation and understanding of the documentation hierarchy. - ---- - ## Build / Test / Lint Workflow Agents must use these exact commands: diff --git a/config/_default/config.yml b/config/_default/config.yml index c128228ab70c..0aba5d88e7c0 100644 --- a/config/_default/config.yml +++ b/config/_default/config.yml @@ -33,11 +33,6 @@ timeout: 300000 outputFormats: rss: baseName: rss - llms: - mediaType: "text/plain" - baseName: "llms" - isPlainText: true - permalinkable: false # 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 @@ -48,7 +43,6 @@ outputs: home: - HTML - JSON - - LLMSTXT section: - HTML diff --git a/layouts/index.llms.txt b/layouts/index.llms.txt deleted file mode 100644 index a9e131be8916..000000000000 --- a/layouts/index.llms.txt +++ /dev/null @@ -1,70 +0,0 @@ -{{- /* Generate llms.txt file for AI/LLM consumption */ -}} -{{- /* Static version for now - dynamic generation can be enabled later */ -}} -# Pulumi - -> Infrastructure as code using real programming languages. Write, test, and deploy cloud infrastructure with TypeScript, Python, Go, C#, or Java instead of YAML. Get IDE support, type safety, and automated testing for AWS, Azure, GCP, Kubernetes, and 150+ providers. - -## Getting Started - -{{- range where .Site.RegularPages "Section" "docs" }} - {{- if and (in .RelPermalink "/get-started/") (not (isset .Params "llms_exclude")) }} -- [{{ .Title }}]({{ .Permalink }}){{ if .Params.meta_desc }} - {{ .Params.meta_desc }}{{ end }} - {{- end }} -{{- end }} -- [Core Concepts](https://www.pulumi.com/docs/iac/concepts/) - Projects, stacks, resources, and state - -## Infrastructure as Code (IaC) - -- [Why Pulumi?](https://www.pulumi.com/docs/iac/) - Real code vs YAML configuration -{{- range where .Site.RegularPages "Section" "docs" }} - {{- if and (in .RelPermalink "/iac/") (not (in .RelPermalink "/get-started/")) (not (isset .Params "llms_exclude")) }} - {{- if or (in .RelPermalink "/languages-sdks/") (in .RelPermalink "/clouds/") (in .RelPermalink "/cli/") (in .RelPermalink "/automation-api/") (in .RelPermalink "/adopting-pulumi/") }} -- [{{ .Title }}]({{ .Permalink }}){{ if .Params.meta_desc }} - {{ .Params.meta_desc | truncate 100 }}{{ end }} - {{- end }} - {{- end }} -{{- end }} - -## Pulumi ESC (Environments, Secrets, Configuration) - -{{- range where .Site.RegularPages "Section" "docs" }} - {{- if and (in .RelPermalink "/esc/") (not (isset .Params "llms_exclude")) }} - {{- if or (eq .RelPermalink "/docs/esc/") (in .RelPermalink "/get-started/") (in .RelPermalink "/environments/") (in .RelPermalink "/integrations/") (in .RelPermalink "/cli/") }} -- [{{ .Title }}]({{ .Permalink }}){{ if .Params.meta_desc }} - {{ .Params.meta_desc | truncate 100 }}{{ end }} - {{- end }} - {{- end }} -{{- end }} - -## Pulumi Cloud Platform - -{{- range where .Site.RegularPages "Section" "docs" }} - {{- if and (in .RelPermalink "/pulumi-cloud/") (not (isset .Params "llms_exclude")) }} - {{- if or (eq .RelPermalink "/docs/pulumi-cloud/") (in .RelPermalink "/deployments/") (in .RelPermalink "/copilot/") (in .RelPermalink "/access-management/") (in .RelPermalink "/admin/") }} -- [{{ .Title }}]({{ .Permalink }}){{ if .Params.meta_desc }} - {{ .Params.meta_desc | truncate 100 }}{{ end }} - {{- end }} - {{- end }} -{{- end }} -- [Pulumi Insights](https://www.pulumi.com/docs/insights/) - Infrastructure intelligence and search - -## Registry (Providers & Packages) - -- [AWS Provider](https://www.pulumi.com/registry/packages/aws/) - Complete AWS resource coverage -- [Azure Native Provider](https://www.pulumi.com/registry/packages/azure-native/) - Full Azure ARM API -- [Google Cloud Provider](https://www.pulumi.com/registry/packages/gcp/) - Complete GCP coverage -- [Kubernetes Provider](https://www.pulumi.com/registry/packages/kubernetes/) - Native Kubernetes support -- [All Providers](https://www.pulumi.com/registry/) - 150+ cloud and SaaS providers - -## API Reference - -- [Node.js/TypeScript](https://www.pulumi.com/docs/reference/pkg/nodejs/) - Complete TypeScript/JavaScript API -- [Python](https://www.pulumi.com/docs/reference/pkg/python/) - Complete Python API -- [Go](https://www.pulumi.com/docs/reference/pkg/go/) - Complete Go API -- [.NET/C#](https://www.pulumi.com/docs/reference/pkg/dotnet/) - Complete .NET API -- [Java](https://www.pulumi.com/docs/reference/pkg/java/) - Complete Java API - -## Resources - -- [Tutorials](https://www.pulumi.com/tutorials/) - Hands-on learning paths -- [Examples](https://github.com/pulumi/examples) - Production-ready templates -- [Templates](https://www.pulumi.com/templates/) - Starter templates for common architectures -- [Blog](https://www.pulumi.com/blog/) - Latest features, best practices, and announcements -- [Case Studies](https://www.pulumi.com/case-studies/) - How BMW, Mercedes-Benz, Snowflake use Pulumi diff --git a/layouts/partials/assets.html b/layouts/partials/assets.html index b7e48639d865..7b2543a4f92e 100644 --- a/layouts/partials/assets.html +++ b/layouts/partials/assets.html @@ -12,7 +12,6 @@ {{ $js := resources.Get "js/bundle.js" | fingerprint }} -