Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation provides both Windows and Linux support in principle, but several sections show Windows bias. PowerShell examples are given in detail, while no Linux-specific shell examples (e.g., Bash) are provided. Template examples use Windows images by default, and admin credentials are shown as username/password rather than SSH keys. Windows tools (PowerShell) are covered in a dedicated section, while Linux equivalents (e.g., Bash scripting, cloud-init) are missing. The CLI section is neutral, but overall, Windows patterns and tools are prioritized.
Recommendations
- Add explicit Linux VM template examples using popular Linux images (e.g., Ubuntu, CentOS) and SSH key authentication.
- Provide Bash or shell scripting equivalents for PowerShell commands, especially for VM and scale set deployments.
- Include Linux-specific guidance for admin credential setup (e.g., using --generate-ssh-keys in CLI, cloud-init for customization).
- Balance the order of examples so that Linux and Windows are equally represented, or alternate which comes first.
- Add notes or links to Linux admin tooling and best practices for ephemeral OS disk deployments.
Create Pull Request