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_tools
⚠️
windows_first
Summary:
The documentation provides extensive PowerShell examples and references, including file paths and commands that are specific to Windows environments (e.g., C:\temp\json.txt), and often lists PowerShell before Azure CLI. There are no explicit Linux shell or Bash examples, and no mention of Linux-specific tools or considerations. This may make the documentation less approachable for Linux users and those who do not use PowerShell.
Recommendations:
- Add Bash shell equivalents for all PowerShell examples, especially for tasks like file manipulation (e.g., using cat, jq, or similar tools for JSON processing).
- Use platform-neutral file paths in examples (e.g., /tmp/json.txt or ./json.txt) or provide both Windows and Linux/Mac paths.
- When listing command-line options, alternate the order or explicitly state that both PowerShell and Azure CLI are cross-platform, and highlight CLI as suitable for Linux/macOS.
- Include a note that Azure CLI commands work natively on Linux/macOS and can be run in Bash or other shells.
- Where PowerShell is used for scripting, provide equivalent Bash scripts or commands for Linux users.
- Review screenshots and UI references to ensure they are not Windows-specific, or provide clarifying notes if UI differs on other platforms.
Create pull request