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
⚠️
missing_linux_example
Summary:
The documentation consistently provides command-line examples using Azure CLI and bash-style syntax (e.g., export, $(...), jq), which are compatible with Linux/macOS and Windows with WSL or Git Bash. However, there are no explicit examples or notes for Windows users using native Command Prompt or PowerShell, nor are there instructions for installing required tools (like jq) on Windows. The documentation implicitly assumes a Unix-like shell environment, which may disadvantage Windows users who do not use WSL or similar tools.
Recommendations:
- Add explicit notes or sections for Windows users, clarifying how to run the commands in PowerShell or Command Prompt, or recommend using WSL or Git Bash.
- Provide Windows-native equivalents for commands that use Unix utilities (e.g., using jq, export, $(...), and piping). For example, show how to set environment variables and parse JSON in PowerShell.
- Include installation instructions for required tools (like jq and Azure CLI) specifically for Windows, with links to Windows installers.
- Where possible, provide both bash and PowerShell command examples side-by-side, or indicate which shell is required for each example.
- Add a 'Platform compatibility' note in the prerequisites, clarifying the expected shell environment and alternatives for Windows users.
Create pull request