Merge pull request #174856 from ggailey777/fix-up

ttorble · web-flow · commit 762f2e2105de · 2021-10-07T11:26:21.000+01:00
[Functions] Clarify that host.json applies to all functions in the app instance
diff --git a/articles/azure-functions/functions-app-settings.md b/articles/azure-functions/functions-app-settings.md
@@ -7,11 +7,11 @@ ms.date: 07/27/2021
 
 # App settings reference for Azure Functions
 
-App settings in a function app contain global configuration options that affect all functions for that function app. When you run locally, these settings are accessed as local [environment variables](functions-develop-local.md#local-settings-file). This article lists the app settings that are available in function apps.
+App settings in a function app contain configuration options that affect all functions for that function app. When you run locally, these settings are accessed as local [environment variables](functions-develop-local.md#local-settings-file). This article lists the app settings that are available in function apps.
 
 [!INCLUDE [Function app settings](../../includes/functions-app-settings.md)]
 
-There are other global configuration options in the [host.json](functions-host-json.md) file and in the [local.settings.json](functions-develop-local.md#local-settings-file) file.
+There are other function app configuration options in the [host.json](functions-host-json.md) file and in the [local.settings.json](functions-develop-local.md#local-settings-file) file.
 Example connection string values are truncated for readability.
 
 > [!NOTE]
@@ -397,6 +397,6 @@ Indicates whether all outbound traffic from the app is routed through the virtua
 
 [Learn how to update app settings](functions-how-to-use-azure-function-app-settings.md#settings)
 
-[See global settings in the host.json file](functions-host-json.md)
+[See configuration settings in the host.json file](functions-host-json.md)
 
 [See other app settings for App Service apps](https://github.com/projectkudu/kudu/wiki/Configurable-settings)
diff --git a/articles/azure-functions/functions-bindings-cosmosdb-v2-output.md b/articles/azure-functions/functions-bindings-cosmosdb-v2-output.md
@@ -695,7 +695,7 @@ By default, when you write to the output parameter in your function, a document
 
 ## host.json settings
 
-This section describes the global configuration settings available for this binding in Azure Functions version 2.x. For more information about global configuration settings in Azure Functions version 2.x, see [host.json reference for Azure Functions version 2.x](functions-host-json.md).
+[!INCLUDE [functions-host-json-section-intro](../../includes/functions-host-json-section-intro.md)]
 
 ```json
 {
diff --git a/articles/azure-functions/functions-bindings-cosmosdb-v2.md b/articles/azure-functions/functions-bindings-cosmosdb-v2.md
@@ -69,7 +69,7 @@ Functions 1.x apps automatically have a reference the [Microsoft.Azure.WebJobs](
 
 ## host.json settings
 
-This section describes the global configuration settings available for this binding in Azure Functions version 2.x. For more information about global configuration settings in Azure Functions version 2.x, see [host.json reference for Azure Functions version 2.x](functions-host-json.md).
+[!INCLUDE [functions-host-json-section-intro](../../includes/functions-host-json-section-intro.md)]
 
 ```json
 {
diff --git a/articles/azure-functions/functions-bindings-http-webhook-output.md b/articles/azure-functions/functions-bindings-http-webhook-output.md
@@ -35,7 +35,7 @@ For example responses, see the [trigger example](./functions-bindings-http-webho
 
 ## host.json settings
 
-This section describes the global configuration settings available for this binding in versions 2.x and higher. The example host.json file below contains only the version 2.x+ settings for this binding. For more information about global configuration settings in versions 2.x and beyond, see [host.json reference for Azure Functions](functions-host-json.md).
+[!INCLUDE [functions-host-json-section-intro](../../includes/functions-host-json-section-intro.md)]
 
 > [!NOTE]
 > For a reference of host.json in Functions 1.x, see [host.json reference for Azure Functions 1.x](functions-host-json-v1.md#http).
@@ -71,4 +71,4 @@ This section describes the global configuration settings available for this bind
 
 ## Next steps
 
-- [Run a function from an HTTP request](./functions-bindings-http-webhook-trigger.md)
+- [Run a function from an HTTP request](./functions-bindings-http-webhook-trigger.md)
diff --git a/articles/azure-functions/functions-bindings-rabbitmq-trigger.md b/articles/azure-functions/functions-bindings-rabbitmq-trigger.md
@@ -260,7 +260,7 @@ Dead letter queues and exchanges can't be controlled or configured from the Rabb
 
 ## host.json settings
 
-This section describes the global configuration settings available for this binding in versions 2.x and higher. The example *host.json* file below contains only the settings for this binding. For more information about global configuration settings, see [host.json reference for Azure Functions version](functions-host-json.md).
+[!INCLUDE [functions-host-json-section-intro](../../includes/functions-host-json-section-intro.md)]
 
 ```json
 {
diff --git a/articles/azure-functions/functions-bindings-sendgrid.md b/articles/azure-functions/functions-bindings-sendgrid.md
@@ -372,7 +372,7 @@ Optional properties may have default values defined in the binding and either ad
 
 ## host.json settings
 
-This section describes the global configuration settings available for this binding in versions 2.x and higher. The example host.json file below contains only the version 2.x+ settings for this binding. For more information about global configuration settings in versions 2.x and beyond, see [host.json reference for Azure Functions](functions-host-json.md).
+[!INCLUDE [functions-host-json-section-intro](../../includes/functions-host-json-section-intro.md)]
 
 > [!NOTE]
 > For a reference of host.json in Functions 1.x, see [host.json reference for Azure Functions 1.x](functions-host-json-v1.md).
diff --git a/articles/azure-functions/functions-bindings-service-bus.md b/articles/azure-functions/functions-bindings-service-bus.md
@@ -62,7 +62,7 @@ Functions 1.x apps automatically have a reference to the [Microsoft.Azure.WebJob
 
 ## host.json settings
 
-This section describes the global configuration settings available for this binding in versions 2.x and higher. The example host.json file below contains only the settings for this binding. For more information about global configuration settings, see [host.json reference for Azure Functions version](functions-host-json.md).
+[!INCLUDE [functions-host-json-section-intro](../../includes/functions-host-json-section-intro.md)]
 
 > [!NOTE]
 > For a reference of host.json in Functions 1.x, see [host.json reference for Azure Functions 1.x](functions-host-json-v1.md).
diff --git a/articles/azure-functions/functions-bindings-storage-blob.md b/articles/azure-functions/functions-bindings-storage-blob.md
@@ -51,10 +51,10 @@ Functions 1.x apps automatically have a reference the [Microsoft.Azure.WebJobs](
 
 ## host.json settings
 
-> [!NOTE]
-> This section does not apply when using extension versions prior to 5.0.0. For those versions, there are no global configuration settings for blobs.
+This section describes the function app configuration settings available for functions that this binding. These settings only apply when using [extension version 5.0.0 and higher](#storage-extension-5x-and-higher). The example host.json file below contains only the version 2.x+ settings for this binding. For more information about function app configuration settings in versions 2.x and later versions, see [host.json reference for Azure Functions](functions-host-json.md).
 
-This section describes the global configuration settings available for this binding when using [extension version 5.0.0 and higher](#storage-extension-5x-and-higher). The example *host.json* file below contains only the version 2.x+ settings for this binding. For more information about global configuration settings in Functions versions 2.x and beyond, see [host.json reference for Azure Functions](functions-host-json.md).
+> [!NOTE]
+> This section doesn't apply to extension versions before 5.0.0. For those earlier versions, there aren't any function app-wide configuration settings for blobs.
 
 ```json
 {
diff --git a/articles/azure-functions/functions-bindings-storage-queue.md b/articles/azure-functions/functions-bindings-storage-queue.md
@@ -53,7 +53,7 @@ Functions 1.x apps automatically have a reference the [Microsoft.Azure.WebJobs](
 
 ## host.json settings
 
-This section describes the global configuration settings available for this binding in versions 2.x and higher. The example *host.json* file below contains only the version 2.x+ settings for this binding. For more information about global configuration settings in versions 2.x and beyond, see [host.json reference for Azure Functions](functions-host-json.md).
+[!INCLUDE [functions-host-json-section-intro](../../includes/functions-host-json-section-intro.md)]
 
 > [!NOTE]
 > For a reference of host.json in Functions 1.x, see [host.json reference for Azure Functions 1.x](functions-host-json-v1.md).
diff --git a/articles/azure-functions/functions-host-json-v1.md b/articles/azure-functions/functions-host-json-v1.md
@@ -11,7 +11,7 @@ ms.date: 10/19/2018
 > * [Version 1](functions-host-json-v1.md)
 > * [Version 2](functions-host-json.md)
 
-The *host.json* metadata file contains global configuration options that affect all functions for a function app. This article lists the settings that are available for the v1 runtime. The JSON schema is at http://json.schemastore.org/host.
+The *host.json* metadata file contains configuration options that affect all functions in a function app instance. This article lists the settings that are available for the version 1.x runtime. The JSON schema is at http://json.schemastore.org/host.
 
 > [!NOTE]
 > This article is for Azure Functions 1.x.  For a reference of host.json in Functions 2.x and later, see [host.json reference for Azure Functions 2.x](functions-host-json.md).
@@ -371,4 +371,4 @@ A set of [shared code directories](functions-reference-csharp.md#watched-directo
 > [Learn how to update the host.json file](functions-reference.md#fileupdate)
 
 > [!div class="nextstepaction"]
-> [See global settings in environment variables](functions-app-settings.md)
+> [Persist settings in environment variables](functions-app-settings.md)
diff --git a/articles/azure-functions/functions-host-json.md b/articles/azure-functions/functions-host-json.md
@@ -11,12 +11,15 @@ ms.date: 04/28/2020
 > * [Version 1](functions-host-json-v1.md)
 > * [Version 2+](functions-host-json.md)
 
-The *host.json* metadata file contains global configuration options that affect all functions for a function app. This article lists the settings that are available starting with version 2.x of the Azure Functions runtime.  
+The host.json metadata file contains configuration options that affect all functions in a function app instance. This article lists the settings that are available starting with version 2.x of the Azure Functions runtime.  
 
 > [!NOTE]
 > This article is for Azure Functions 2.x and later versions.  For a reference of host.json in Functions 1.x, see [host.json reference for Azure Functions 1.x](functions-host-json-v1.md).
 
-Other function app configuration options are managed in your [app settings](functions-app-settings.md) (for deployed apps) or your [local.settings.json](functions-develop-local.md#local-settings-file) file (for local development).
+Other function app configuration options are managed depending on where the function app runs:
+
++ **Deployed to Azure**: in your [application settings](functions-app-settings.md) 
++ **On your local computer**: in the [local.settings.json](functions-develop-local.md#local-settings-file) file.
 
 Configurations in host.json related to bindings are applied equally to each function in the function app. 
 
@@ -235,7 +238,7 @@ This setting is a child of [logging](#logging). It controls the console logging
 
 |Property  |Default | Description |
 |---------|---------|---------| 
-|DisableColors|false| Supresses log formatting in the container logs on Linux. Set to true if you are seeing unwanted ANSI control characters in the container logs when running on Linux. |
+|DisableColors|false| Suppresses log formatting in the container logs on Linux. Set to true if you are seeing unwanted ANSI control characters in the container logs when running on Linux. |
 |isEnabled|false|Enables or disables console logging.| 
 
 ## cosmosDb
diff --git a/articles/azure-functions/functions-reference-python.md b/articles/azure-functions/functions-reference-python.md
@@ -93,7 +93,7 @@ The main project folder (<project_root>) can contain the following files:
 
 * *local.settings.json*: Used to store app settings and connection strings when running locally. This file doesn't get published to Azure. To learn more, see [local.settings.file](functions-develop-local.md#local-settings-file).
 * *requirements.txt*: Contains the list of Python packages the system installs when publishing to Azure.
-* *host.json*: Contains global configuration options that affect all functions in a function app. This file does get published to Azure. Not all options are supported when running locally. To learn more, see [host.json](functions-host-json.md).
+* *host.json*: Contains configuration options that affect all functions in a function app instance. This file does get published to Azure. Not all options are supported when running locally. To learn more, see [host.json](functions-host-json.md).
 * *.vscode/*: (Optional) Contains store VSCode configuration. To learn more, see [VSCode setting](https://code.visualstudio.com/docs/getstarted/settings).
 * *.venv/*: (Optional) Contains a Python virtual environment used by local development.
 * *Dockerfile*: (Optional) Used when publishing your project in a [custom container](functions-create-function-linux-custom-image.md).
diff --git a/includes/functions-host-json-section-intro.md b/includes/functions-host-json-section-intro.md
@@ -0,0 +1,9 @@
+---
+author: ggailey777
+ms.service: azure-functions
+ms.topic: include
+ms.date: 10/05/2021
+ms.author: glenga
+---
+
+This section describes the configuration settings available for this binding in versions 2.x and higher. Settings in the host.json file apply to all functions in a function app instance. The example host.json file below contains only the version 2.x+ settings for this binding. For more information about function app configuration settings in versions 2.x and later versions, see [host.json reference for Azure Functions](../articles/azure-functions/functions-host-json.md).

Original file line number	Diff line number	Diff line change
`@@ -695,7 +695,7 @@ By default, when you write to the output parameter in your function, a document`
`695`	`695`
`696`	`696`	`## host.json settings`
`697`	`697`
`698`		`-This section describes the global configuration settings available for this binding in Azure Functions version 2.x. For more information about global configuration settings in Azure Functions version 2.x, see [host.json reference for Azure Functions version 2.x](functions-host-json.md).`
	`698`	`+[!INCLUDE [functions-host-json-section-intro](../../includes/functions-host-json-section-intro.md)]`
`699`	`699`
`700`	`700`	```json
`701`	`701`	`{`
Original file line number	Diff line number	Diff line change
`@@ -69,7 +69,7 @@ Functions 1.x apps automatically have a reference the [Microsoft.Azure.WebJobs](`
`69`	`69`
`70`	`70`	`## host.json settings`
`71`	`71`
`72`		`-This section describes the global configuration settings available for this binding in Azure Functions version 2.x. For more information about global configuration settings in Azure Functions version 2.x, see [host.json reference for Azure Functions version 2.x](functions-host-json.md).`
	`72`	`+[!INCLUDE [functions-host-json-section-intro](../../includes/functions-host-json-section-intro.md)]`
`73`	`73`
`74`	`74`	```json
`75`	`75`	`{`
Original file line number	Diff line number	Diff line change
`@@ -260,7 +260,7 @@ Dead letter queues and exchanges can't be controlled or configured from the Rabb`
`260`	`260`
`261`	`261`	`## host.json settings`
`262`	`262`
`263`		`-This section describes the global configuration settings available for this binding in versions 2.x and higher. The example host.json file below contains only the settings for this binding. For more information about global configuration settings, see [host.json reference for Azure Functions version](functions-host-json.md).`
	`263`	`+[!INCLUDE [functions-host-json-section-intro](../../includes/functions-host-json-section-intro.md)]`
`264`	`264`
`265`	`265`	```json
`266`	`266`	`{`