Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
missing_linux_example
windows_first
Summary
The documentation page demonstrates a strong bias toward Windows and PowerShell. All command-line examples use Azure PowerShell cmdlets, with no mention of Bash, Azure CLI, or Linux/macOS workflows. Instructions for assigning roles and configuring source control are exclusively provided for PowerShell, and references to file encoding issues link to PowerShell/VSCode documentation. There are no Linux/macOS-specific instructions or parity examples, and Windows tools and patterns are presented first and exclusively.
Recommendations
- Add equivalent examples using Azure CLI and Bash for all PowerShell command-line instructions, especially for role assignment and source control configuration.
- Explicitly state platform compatibility for PowerShell cmdlets and clarify if they can be run on Linux/macOS (e.g., via PowerShell Core).
- Provide guidance for Linux/macOS users on prerequisites, authentication, and troubleshooting, including common editors and encoding issues.
- Include links to cross-platform documentation and tools where available.
- Reorder or balance examples so that Windows and Linux/macOS instructions are presented with equal prominence.
Create Pull Request