Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation displays a moderate Windows bias. In several examples, the OS type is set to 'Windows' by default, and PowerShell commands are given equal prominence to CLI, with detailed notes about PowerShell multiline syntax. There are no explicit Linux/macOS shell examples (e.g., Bash), and the CLI examples use variable syntax that is more common in Bash but do not clarify Linux/macOS usage. The documentation does not mention Linux-specific considerations or show Linux as an OS type in creation examples.
Recommendations
- Provide explicit Linux/macOS shell examples (e.g., Bash) alongside PowerShell, especially for Azure CLI commands.
- Show disk creation examples with 'osType' set to 'Linux' as well as 'Windows'.
- Add notes or sections clarifying any differences or additional steps for Linux/macOS users.
- Balance the order of examples so that Linux/Bash and Windows/PowerShell are presented equally, or alternate which comes first.
- Remove unnecessary PowerShell-specific notes from sections that are not PowerShell-focused, or add equivalent notes for Bash if needed.
Create Pull Request