diff --git a/aspnetcore/fundamentals/configuration/index.md b/aspnetcore/fundamentals/configuration/index.md index 7427800d5427..62fe29e96066 100644 --- a/aspnetcore/fundamentals/configuration/index.md +++ b/aspnetcore/fundamentals/configuration/index.md @@ -138,6 +138,16 @@ Using the [default](#default) configuration, the `appsettings.json` and `appsett Comments in `appsettings.json` and `appsettings.{Environment}.json` files are supported using JavaScript or [C# style comments](/dotnet/csharp/language-reference/tokens/comments). +Some integrated development environments (IDE) display errors when editing a JSON file that contains comments. You can generally ignore comment errors and warnings, but you can also usually disable them with a setting in the IDE. In Visual Studio Code, for example, add the following to the `settings.json` file to disable the errors: + +```json +"files.associations": { + "appsettings*.json": "jsonc" +} +``` + +For other IDEs, check the tool's documentation and other product support channels to determine how to silence the errors. + ### Bind hierarchical configuration data using the options pattern