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 presents file path examples and CLI usage with Windows-style paths (e.g., C:/Users/john/Downloads/data.json, D:/abc.json) and does not provide equivalent Linux/macOS path examples. There are no explicit Linux or macOS shell command examples, and all CLI instructions use Windows conventions by default. This may give the impression that the documentation is primarily intended for Windows users, potentially making Linux/macOS users feel less supported.
Recommendations:
- For every CLI example that uses a Windows-style file path, provide an equivalent Linux/macOS example (e.g., /home/john/data.json).
- Explicitly mention that the Azure CLI commands work on Windows, Linux, and macOS, and show at least one example per platform where file paths or shell conventions differ.
- Where referencing the Azure Cloud Shell, clarify that it is available in-browser and supports both Bash and PowerShell, and provide examples for both where relevant.
- Avoid using only Windows drive letters (C:/, D:/) in examples; use generic or cross-platform paths, or alternate between Windows and Linux/macOS paths in examples.
- If referencing commands to retrieve resource IDs or similar, show both PowerShell and Bash variants if there are differences.
Create pull request