Document Details

Create Communication Resource
Home / Scan #41 / Create Communication Resource
Sad Tux - Windows bias detected
This page contains Windows bias

About This Page

This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
GitHub View on GitHub 📚 View on Microsoft Learn

Bias Analysis

Detected Bias Types
windows_first
powershell_heavy
windows_tools
Summary
The documentation shows some Windows bias. Windows and PowerShell are prioritized in several places: the Azure CLI installation link defaults to Windows, environment variable instructions list Windows first, and .NET/PowerShell are highlighted as management SDKs. While Linux and macOS instructions are present, Windows tools and patterns are often mentioned first or more prominently.
Recommendations
  • Provide equal prominence to Linux and macOS instructions by rotating or randomizing the order of OS tabs, or by listing Linux/macOS first in some sections.
  • When linking to installation instructions (e.g., Azure CLI), use a cross-platform link or provide links for all major OSes.
  • Include more examples using Bash or other common Linux shells, not just PowerShell or Windows command prompt.
  • Mention cross-platform SDKs and tools (like Azure CLI and REST APIs) before platform-specific ones (like .NET or PowerShell).
  • Ensure that screenshots and sample file paths are not Windows-specific unless necessary.
  • Where possible, provide parity in troubleshooting tips and notes for Linux/macOS users.
GitHub Create Pull Request

Scan History

Date Scan Status Result
2025-07-12 23:44 #41 cancelled Biased Biased
2025-07-12 00:58 #8 cancelled Clean Clean
2025-07-10 05:06 #7 processing Clean Clean

Flagged Code Snippets

## Store your connection string

Communication Services SDKs use connection strings to authorize requests made to Communication Services. You have several options for storing your connection string:

* An application running on the desktop or on a device can store the connection string in an **app.config** or **web.config** file. Add the connection string to the **AppSettings** section in these files.
* An application running in an Azure App Service can store the connection string in the [App Service application settings](../../app-service/configure-common.md). Add the connection string to the **Connection Strings** section of the Application Settings tab within the portal.
* You can store your connection string in [Azure Key Vault](../../data-factory/store-credentials-in-key-vault.md). You can further securely [manage your connection string](../../storage/common/storage-account-keys-manage.md).
* If you're running your application locally, you may want to store your connection string in an environment variable.

### Store your connection string in an environment variable

To configure an environment variable, open a console window and select your operating system from the following tabs. Replace `<yourconnectionstring>` with your actual connection string.

#### [Windows](#tab/windows)

Open a console window and enter the following command: