Detected Bias Types
Powershell Heavy
π§
Windows Tools
Windows First
Summary
The documentation provides examples for the Azure portal, PowerShell, and Azure CLI. PowerShell is featured heavily throughout, with detailed explanations and multiple code samples. There are frequent references to PowerShell-specific tools and patterns (e.g., cmdlets, installation instructions, usage in Cloud Shell, and local installation guidance). PowerShell is a Windows-centric tool, and its prominence may suggest a bias toward Windows users. The documentation also references Azure Storage Explorer, which is available cross-platform but is often associated with Windows environments. While Azure CLI is included and is cross-platform, PowerShell examples and instructions are generally more detailed and sometimes appear before CLI equivalents.
Recommendations
- Ensure Azure CLI examples are as detailed and comprehensive as PowerShell examples, including variable usage and advanced scenarios.
- Explicitly mention that Azure CLI is cross-platform and highlight its parity with PowerShell for Linux and macOS users.
- Add Bash shell examples for common operations, especially for Linux users, where appropriate.
- Clarify that Azure Cloud Shell supports both Bash and PowerShell, and provide instructions for both.
- Avoid language that assumes PowerShell is the default or preferred scripting environment.
- Where tools like Azure Storage Explorer are mentioned, note their cross-platform availability and provide links to Linux/macOS installation guides.