Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation demonstrates mild Windows bias in several areas. Windows-specific details (such as page file placement) are discussed more thoroughly and appear before Linux equivalents. PowerShell is mentioned explicitly for customer-managed keys, with Linux CLI only referenced secondarily. Examples and sizing guidance for Windows images are presented before Linux images, and some sections (like page file placement) only discuss Windows patterns. There is a lack of parity in example depth and tool coverage for Linux/macOS users.
Recommendations
- Ensure Linux and Windows examples are presented with equal prominence and detail, ideally side-by-side.
- Include explicit Linux/macOS command-line examples (e.g., Bash, Azure CLI) wherever PowerShell is referenced.
- Discuss Linux-specific disk/file system patterns (e.g., swap file placement) in sections that currently only mention Windows details.
- When mentioning tools or deployment methods (CLI, PowerShell, Portal), list Linux/macOS options first or equally.
- Add more Linux image sizing examples and clarify any differences in deployment or management for Linux VMs.
Create Pull Request