Detected Bias Types
Windows First
Powershell Heavy
🔧
Windows Tools
Missing Linux Example
Summary
The documentation demonstrates several forms of Windows bias. In command-line examples, both Azure CLI and Azure PowerShell are consistently provided, but there is a notable emphasis on PowerShell, a Windows-centric tool. In some sections (e.g., migration), only Windows migration is supported and documented, with Linux explicitly excluded. Throughout, Windows is often mentioned first (e.g., in region tables, OS requirements), and there is a lack of Linux-specific guidance or parity in examples. Additionally, Windows tools and patterns (like PowerShell) are given equal or greater prominence than cross-platform tools, and there are no Linux shell (bash) or scripting examples provided.
Recommendations
- Ensure all command-line examples are clearly marked as cross-platform, and provide bash or shell script equivalents where possible, especially for Linux users.
- When referencing PowerShell, clarify its cross-platform availability or provide alternatives (e.g., bash/Cloud Shell) for Linux users.
- Avoid consistently listing Windows first in tables and descriptions; alternate or clarify that both OSes are equally supported where applicable.
- For migration and other features not supported on Linux, provide clear guidance, workarounds, or timelines for Linux support.
- Add Linux-specific notes, troubleshooting, and best practices to match the level of detail provided for Windows.
- Review and balance the use of Windows-centric terminology and tools with Linux equivalents throughout the documentation.