Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
windows_tools
Summary
The documentation page demonstrates a strong Windows bias. All code examples for creating and deploying resources use Azure PowerShell, with no equivalent Azure CLI or Bash examples provided. The tutorial centers on deploying a Windows VM, referencing Windows-specific password requirements and using RDP for validation. Linux VM scenarios, tools, and deployment patterns are absent, and the use of PowerShell is prioritized throughout, even when Cloud Shell supports Bash/CLI. Windows tools and workflows are mentioned exclusively or before any Linux alternatives.
Recommendations
- Provide Azure CLI (az) and Bash examples alongside PowerShell scripts for all resource creation and deployment steps.
- Include a parallel tutorial or examples for deploying a Linux VM, referencing Linux-specific password/SSH requirements.
- Mention and demonstrate Linux connection methods (e.g., SSH) in the validation section, not just RDP.
- Reference Linux documentation and password requirements where appropriate.
- Ensure that instructions for Cloud Shell do not default to PowerShell, but present Bash/CLI as an equal option.
- Balance the use of Windows and Linux terminology, tools, and workflows throughout the tutorial.
Create Pull Request