Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation page demonstrates a mild Windows bias by listing Azure PowerShell before Azure CLI in several places, and by providing explicit PowerShell command examples while only briefly mentioning Azure CLI equivalents. There are no Linux-specific tools or workflows mentioned, and the focus on Visual Studio Code (a cross-platform editor, but traditionally associated with Windows) is not balanced with mention of other editors or shell environments.
Recommendations
- Present Azure CLI examples before or alongside PowerShell examples, especially since Azure CLI is cross-platform and widely used on Linux.
- Explicitly mention that all tools (VS Code, Azure CLI, Bicep linter, etc.) are available on Linux, and provide links or notes for Linux users where appropriate.
- Include example commands for both PowerShell and Bash shells when referencing command-line troubleshooting.
- Consider mentioning other popular cross-platform or Linux-native editors (such as Vim or Emacs) for syntax checking, or clarify that the VS Code extensions work on Linux.
- Avoid defaulting to Windows-first terminology or ordering; strive for parity in tool and example presentation.
Create Pull Request