From b0e24ccf47b096d7a4ce3c45639dc66df875145a Mon Sep 17 00:00:00 2001 From: Alberto Pose Date: Wed, 26 Nov 2025 11:17:00 +0000 Subject: [PATCH 1/2] Enhance project file documentation for infra Pulumi YAML Fixes #16674 Expanded explanation of the project file's role in Pulumi YAML programs by adding details about top-level attributes. --- content/docs/iac/concepts/projects/project-file.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/iac/concepts/projects/project-file.md b/content/docs/iac/concepts/projects/project-file.md index dcebc0fa58d9..0d5524fcbe03 100644 --- a/content/docs/iac/concepts/projects/project-file.md +++ b/content/docs/iac/concepts/projects/project-file.md @@ -22,7 +22,7 @@ aliases: Every Pulumi program has a project file, `Pulumi.yaml`, which specifies metadata about your project, such as the project name and language runtime. The project file must begin with a capital `P` and have an extension of either `.yml` or `.yaml`. For more information about Pulumi projects, see the following [Pulumi projects overview](/docs/intro/concepts/project/). {{< notes >}} -For Pulumi programs specifically written in Pulumi YAML, the project file not only serves as a configuration and metadata repository but also contains the program's infrastructure definition itself. To learn more, see [Pulumi YAML](/docs/intro/languages/yaml/). +For Pulumi programs specifically written in Pulumi YAML, the project file not only serves as a configuration and metadata repository but also contains the program's infrastructure definition itself. For instance, the `resources`, `variables`, and `outputs` are [top-level attributes related to infrastructure](/docs/iac/languages-sdks/yaml/yaml-language-reference/). To learn more, see [Pulumi YAML](/docs/intro/languages/yaml/). {{< /notes >}} ## Attributes From 61a34951d0708c074000cc6e43e8f114b7c8c5b8 Mon Sep 17 00:00:00 2001 From: "claude[bot]" <41898282+claude[bot]@users.noreply.github.com> Date: Wed, 26 Nov 2025 11:30:48 +0000 Subject: [PATCH 2/2] Improve wording for YAML project file documentation Changed "top-level attributes related to infrastructure" to "top-level properties that define your infrastructure" for better technical accuracy and clarity. Co-authored-by: Alberto Pose --- content/docs/iac/concepts/projects/project-file.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/iac/concepts/projects/project-file.md b/content/docs/iac/concepts/projects/project-file.md index 0d5524fcbe03..ce1fc8c1eab8 100644 --- a/content/docs/iac/concepts/projects/project-file.md +++ b/content/docs/iac/concepts/projects/project-file.md @@ -22,7 +22,7 @@ aliases: Every Pulumi program has a project file, `Pulumi.yaml`, which specifies metadata about your project, such as the project name and language runtime. The project file must begin with a capital `P` and have an extension of either `.yml` or `.yaml`. For more information about Pulumi projects, see the following [Pulumi projects overview](/docs/intro/concepts/project/). {{< notes >}} -For Pulumi programs specifically written in Pulumi YAML, the project file not only serves as a configuration and metadata repository but also contains the program's infrastructure definition itself. For instance, the `resources`, `variables`, and `outputs` are [top-level attributes related to infrastructure](/docs/iac/languages-sdks/yaml/yaml-language-reference/). To learn more, see [Pulumi YAML](/docs/intro/languages/yaml/). +For Pulumi programs specifically written in Pulumi YAML, the project file not only serves as a configuration and metadata repository but also contains the program's infrastructure definition itself. For instance, `resources`, `variables`, and `outputs` are [top-level properties that define your infrastructure](/docs/iac/languages-sdks/yaml/yaml-language-reference/). To learn more, see [Pulumi YAML](/docs/intro/languages/yaml/). {{< /notes >}} ## Attributes