Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
missing_linux_example
windows_first
Summary
The documentation demonstrates a Windows bias by providing only PowerShell command examples for certificate management and updates, without offering equivalent Azure CLI or Bash examples. The use of PowerShell as the sole scripting tool assumes a Windows environment. Additionally, when mentioning programmatic alternatives to the portal, 'ARM template, CLI, or PowerShell' are listed, but only PowerShell examples are shown. There are no Linux-specific instructions or screenshots, and the portal navigation assumes a GUI typical of Windows users.
Recommendations
- Add equivalent Azure CLI (az) command examples for all PowerShell scripts, especially for certificate upload/update and Key Vault operations.
- Where programmatic options are mentioned (ARM template, CLI, PowerShell), provide examples for both CLI and PowerShell.
- Explicitly state that the Azure CLI commands can be run on Linux, macOS, and Windows, and provide Bash shell examples where appropriate.
- Include screenshots or instructions for using the Azure portal from non-Windows environments (e.g., browser-agnostic language).
- Review the order of tool mentions to avoid always listing Windows tools first; alternate or group by platform.
Create Pull Request