About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
Bias Types:
⚠️
windows_first
⚠️
windows_tools
Summary:
The documentation demonstrates a subtle Windows bias by using Windows-style path separators (backslashes) in 'cd' commands and referencing 'notepad' as a temporary storage tool. While the Azure CLI is cross-platform and the instructions are generally platform-agnostic, these details may confuse or inconvenience Linux/macOS users. There are no explicit PowerShell examples, but the path and tool references assume a Windows environment.
Recommendations:
- Use forward slashes (/) in directory paths for 'cd' commands, or provide both Windows (\) and Linux/macOS (/) variants.
- Replace references to 'notepad' with a generic instruction such as 'save the output in a temporary text file', or mention cross-platform editors (e.g., 'use a text editor of your choice').
- Explicitly state that all CLI commands work on Windows, Linux, and macOS, and provide notes or tabs for OS-specific differences if relevant.
- Consider including a short section or callout for Linux/macOS users to clarify any differences in command usage or environment setup.
Create pull request
Flagged Code Snippets
# Change directory to the SMI sample
cd serviceconnector-webapp-appconfig-dotnet\system-managed-identity
# Create a web app
LOCATION='eastus'
RESOURCE_GROUP_NAME='service-connector-tutorial-rg'
APP_SERVICE_NAME='webapp-appconfig-smi'
az webapp up --location $LOCATION --resource-group $RESOURCE_GROUP_NAME --name $APP_SERVICE_NAME
# Change directory to the UMI sample
cd serviceconnector-webapp-appconfig-dotnet\user-assigned-managed-identity
# Create a web app
LOCATION='eastus'
RESOURCE_GROUP_NAME='service-connector-tutorial-rg'
APP_SERVICE_NAME='webapp-appconfig-umi'
az webapp up --location $LOCATION --resource-group $RESOURCE_GROUP_NAME --name $APP_SERVICE_NAME
# Change directory to the service principal sample
cd serviceconnector-webapp-appconfig-dotnet\service-principal
# Create a web app
LOCATION='eastus'
RESOURCE_GROUP_NAME='service-connector-tutorial-rg'
APP_SERVICE_NAME='webapp-appconfig-sp'
az webapp up --location $LOCATION --resource-group $RESOURCE_GROUP_NAME --name $APP_SERVICE_NAME
# Change directory to the service principal sample
cd serviceconnector-webapp-appconfig-dotnet\connection-string
# Create a web app
LOCATION='eastus'
RESOURCE_GROUP_NAME='service-connector-tutorial-rg'
APP_SERVICE_NAME='webapp-appconfig-cs'
az webapp up --location $LOCATION --resource-group $RESOURCE_GROUP_NAME --name $APP_SERVICE_NAME