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
⚠️
windows_tools
Summary:
The documentation demonstrates a Windows bias by using Windows-style file paths (e.g., c:\Templates\deployTS\azuredeploy.json) throughout, and does not provide Linux/macOS equivalents or mention cross-platform considerations. All file path examples and instructions assume a Windows environment. While both Azure PowerShell and Azure CLI examples are provided, the CLI examples also use Windows paths, and there are no explicit Linux shell or path examples. There is also a note about a known issue with Windows PowerShell, but no mention of Linux-specific issues or guidance.
Recommendations:
- Provide file path examples for both Windows (e.g., c:\Templates\deployTS\azuredeploy.json) and Linux/macOS (e.g., ~/Templates/deployTS/azuredeploy.json or /home/user/Templates/deployTS/azuredeploy.json) in all relevant code snippets and instructions.
- Explicitly state that the Azure CLI is cross-platform and show examples using both Windows Command Prompt/PowerShell and Linux/macOS shells (e.g., Bash).
- Include notes about any platform-specific issues for both Windows and Linux/macOS, not just Windows.
- Wherever possible, use environment variables or relative paths that are platform-agnostic in CLI examples.
- Consider adding tabs or callouts for 'Windows', 'Linux', and 'macOS' when showing command-line examples to improve clarity for users on different platforms.
Create pull request