Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation page demonstrates a notable Windows bias. All code examples use Windows-specific paths (e.g., C:\workspaces), PowerShell scripts, and Windows-only tools like winget. There are no Linux/macOS equivalents or examples, and Windows conventions are presented exclusively and first. This creates friction for Linux/macOS users who may not be able to directly apply the instructions.
Recommendations
- Provide Linux/macOS equivalents for all customization examples, including file paths and shell commands.
- Include examples using Bash or sh instead of only PowerShell.
- Mention cross-platform installation methods for Azure CLI (e.g., apt, yum, Homebrew) alongside winget.
- Clarify which steps and tools are platform-specific, and offer alternatives where possible.
- Show how to clone repositories and hydrate secrets on Linux/macOS Dev Boxes.
Create Pull Request