Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
Summary
The documentation demonstrates a Windows bias by prioritizing the Azure Portal (a GUI tool most commonly used on Windows) and Azure CLI examples, with CLI code blocks labeled as 'azurepowershell-interactive' and 'azurecli-interactive'. There is no mention of Linux-specific shell environments, nor are there explicit Bash or cross-platform shell examples. The documentation does not provide any Linux-specific instructions or screenshots, and the use of the Azure Portal is presented first in all cases.
Recommendations
- Add explicit Bash/Linux shell examples for all CLI commands, using the 'bash' code block label where appropriate.
- Clarify that the Azure CLI commands work cross-platform (Windows, macOS, Linux) and provide any necessary notes about differences in shell syntax.
- Include screenshots or instructions for the Azure Portal on Linux/macOS (if available), or clarify platform requirements.
- Avoid labeling CLI code blocks as 'azurepowershell-interactive' unless they are specifically for PowerShell; use 'azurecli' or 'bash' as appropriate.
- Consider providing a 'Linux/macOS' tab for steps that might differ from Windows, especially for command-line usage.
- Explicitly mention that all SDKs and CLI commands are supported on Linux, and provide links to Linux installation guides for Azure CLI if not already present.
Create Pull Request