Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
Summary
The documentation page demonstrates Windows bias by presenting Azure PowerShell examples before Azure CLI examples, and by exclusively referencing the Azure portal (which is most commonly used on Windows) for GUI-based instructions. The scripting examples for managing private endpoints and cache resources are provided first in PowerShell, a tool native to Windows, with Azure CLI examples following. There are no explicit Linux-specific instructions, nor are Linux shell patterns (such as Bash or shell scripting) mentioned. The documentation does not reference Linux tools or provide parity for Linux users beyond the Azure CLI, which is cross-platform but not highlighted as such.
Recommendations
- Present Azure CLI examples before or alongside PowerShell examples to emphasize cross-platform support.
- Explicitly mention that Azure CLI commands work on Linux, macOS, and Windows, and provide shell-specific notes where relevant.
- Include instructions or screenshots for using the Azure portal on non-Windows platforms (e.g., macOS, Linux browsers) if there are differences.
- Add Bash script examples for automation tasks, especially for Linux users.
- Where PowerShell is referenced, clarify its availability on Linux and macOS, or suggest Azure CLI as the preferred cross-platform tool.
- Review terminology to avoid implicit Windows-first assumptions (e.g., avoid phrases like 'run the following PowerShell script' without offering alternatives).
Create Pull Request