Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
Summary
The documentation shows mild Windows bias: Windows-specific installation instructions for Azure CLI are listed before Linux/macOS, Azure PowerShell (a Windows-centric tool) is presented as an equal option to Azure CLI, and PowerShell examples are given first in all code tabs. There is no explicit Linux example for shell scripting (e.g., Bash vs. PowerShell), and Visual Studio Code is suggested as the editor, which, while cross-platform, is often associated with Windows. The cleanup instructions use the Azure portal, which is platform-neutral.
Recommendations
- List Azure CLI installation instructions for Linux/macOS before Windows, or group them together to avoid Windows-first ordering.
- Present Azure CLI (which is cross-platform and preferred for Linux) examples before PowerShell, or alternate the order in code tabs.
- Explicitly state that CLI examples are Bash-compatible and provide any necessary notes for Linux/macOS users (e.g., file path conventions, shell differences).
- Mention alternative editors for Linux (e.g., Vim, nano) alongside Visual Studio Code.
- Add a brief note on using the Azure CLI in native Linux environments, and clarify that PowerShell is available cross-platform but is more commonly used on Windows.
Create Pull Request