From 282f7efec6f64a7f83e4288f3554fc9b44656a28 Mon Sep 17 00:00:00 2001
From: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
Date: Thu, 16 Sep 2021 15:44:14 -0700
Subject: [PATCH 1/3] add property

---
 docs/core/project-sdk/msbuild-props.md | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/docs/core/project-sdk/msbuild-props.md b/docs/core/project-sdk/msbuild-props.md
index a3200c8563957..6e8bc732d7b62 100644
--- a/docs/core/project-sdk/msbuild-props.md
+++ b/docs/core/project-sdk/msbuild-props.md
@@ -258,6 +258,7 @@ The following MSBuild properties are documented in this section:
 - [RuntimeFrameworkVersion](#runtimeframeworkversion)
 - [RuntimeIdentifier](#runtimeidentifier)
 - [RuntimeIdentifiers](#runtimeidentifiers)
+- [SatelliteResourceLanguages](#satelliteresourcelanguages)
 - [UseAppHost](#useapphost)
 
 ### AppendTargetFrameworkToOutputPath
@@ -396,6 +397,16 @@ The `RuntimeIdentifiers` property lets you specify a semicolon-delimited list of
 </PropertyGroup>
 ```
 
+## SatelliteResourceLanguages
+
+The `SatelliteResourceLanguages` property lets you specify which languages you want to preserve satellite resource assemblies for during publish. Many NuGet packages include localized resource satellite assemblies in the main package. For projects that reference these NuGet packages that don't require localized resources, the localized assemblies can unnecessarily inflate the publish output size. By adding the `SatelliteResourceLanguages` property to your project file, only localized assemblies for the languages you specify will be included in the publish output. For example, in the following project file, only English (US) resource satellite assemblies will be retained.
+
+```xml
+<PropertyGroup>
+  <SatelliteResourceLanguages>en-US</SatelliteResourceLanguages>
+</PropertyGroup>
+```
+
 ### UseAppHost
 
 The `UseAppHost` property controls whether or not a native executable is created for a deployment. A native executable is required for self-contained deployments.

From 38d16caa401f67ac0780fdc536ee9730ef8908f1 Mon Sep 17 00:00:00 2001
From: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
Date: Thu, 16 Sep 2021 15:46:14 -0700
Subject: [PATCH 2/3] add note

---
 docs/core/project-sdk/msbuild-props.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/docs/core/project-sdk/msbuild-props.md b/docs/core/project-sdk/msbuild-props.md
index 6e8bc732d7b62..824c73c093025 100644
--- a/docs/core/project-sdk/msbuild-props.md
+++ b/docs/core/project-sdk/msbuild-props.md
@@ -407,6 +407,9 @@ The `SatelliteResourceLanguages` property lets you specify which languages you w
 </PropertyGroup>
 ```
 
+> [!NOTE]
+> You must specify this property in the project that references the NuGet package with localized resource satellite assemblies.
+
 ### UseAppHost
 
 The `UseAppHost` property controls whether or not a native executable is created for a deployment. A native executable is required for self-contained deployments.

From a56e1e8525ef7c7244dc3dc2241174d7a039620e Mon Sep 17 00:00:00 2001
From: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
Date: Fri, 17 Sep 2021 12:30:42 -0700
Subject: [PATCH 3/3] Update docs/core/project-sdk/msbuild-props.md

Co-authored-by: Damian Edwards <damian@damianedwards.com>
---
 docs/core/project-sdk/msbuild-props.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/core/project-sdk/msbuild-props.md b/docs/core/project-sdk/msbuild-props.md
index 824c73c093025..bf22df064992e 100644
--- a/docs/core/project-sdk/msbuild-props.md
+++ b/docs/core/project-sdk/msbuild-props.md
@@ -399,7 +399,7 @@ The `RuntimeIdentifiers` property lets you specify a semicolon-delimited list of
 
 ## SatelliteResourceLanguages
 
-The `SatelliteResourceLanguages` property lets you specify which languages you want to preserve satellite resource assemblies for during publish. Many NuGet packages include localized resource satellite assemblies in the main package. For projects that reference these NuGet packages that don't require localized resources, the localized assemblies can unnecessarily inflate the publish output size. By adding the `SatelliteResourceLanguages` property to your project file, only localized assemblies for the languages you specify will be included in the publish output. For example, in the following project file, only English (US) resource satellite assemblies will be retained.
+The `SatelliteResourceLanguages` property lets you specify which languages you want to preserve satellite resource assemblies for during build and publish. Many NuGet packages include localized resource satellite assemblies in the main package. For projects that reference these NuGet packages that don't require localized resources, the localized assemblies can unnecessarily inflate the build and publish output size. By adding the `SatelliteResourceLanguages` property to your project file, only localized assemblies for the languages you specify will be included in the build and publish output. For example, in the following project file, only English (US) resource satellite assemblies will be retained.
 
 ```xml
 <PropertyGroup>