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:
⚠️
powershell_heavy
⚠️
windows_first
⚠️
windows_tools
⚠️
missing_linux_example
Summary:
The documentation page demonstrates a Windows bias by referencing PowerShell for resource group creation (via include), mentioning Windows before Linux in the OpenSSL prerequisite, and suggesting Visual Studio/Visual Studio Code (commonly associated with Windows) for authentication. There are no explicit Linux/macOS-specific instructions or examples, and the setup steps (such as creating a virtual environment) link to documentation that defaults to Windows command prompt. No Linux shell (bash) or cross-platform CLI examples are provided for resource group creation or authentication.
Recommendations:
- Provide explicit Linux/macOS shell (bash) examples alongside or before PowerShell/Windows examples for resource group creation and other CLI steps.
- Rephrase prerequisites to mention Linux/macOS before or alongside Windows, e.g., 'on a computer running Linux, macOS, or Windows.'
- Include instructions for using cross-platform tools (e.g., Azure CLI) for all steps, not just cleanup.
- Avoid suggesting Windows-centric tools (like Visual Studio) as the primary authentication method; mention cross-platform editors and tools equally.
- Ensure all included snippets (such as resource group creation) have both PowerShell and bash equivalents, or use Azure CLI as the default.
Create pull request