Detected Bias Types
Missing Linux Example
Windows First
Summary
The documentation provides configuration steps and examples only for the Azure Portal (a web GUI) and the Azure CLI, with no mention of Linux-specific tools or shell environments. While Azure CLI is cross-platform, all CLI examples use Bash-style syntax (e.g., variable assignment with $()), which is not native to Windows Command Prompt or PowerShell. However, there are no PowerShell examples, and the documentation does not explicitly address Linux users or provide Linux-specific guidance. The 'Portal' instructions implicitly assume a GUI environment, which is more common on Windows. There is also no mention of Linux command-line environments or alternative tools (e.g., Azure CLI on Linux, Cloud Shell, etc.), and no explicit validation that the steps are tested or applicable on Linux.
Recommendations
- Explicitly state that Azure CLI commands are cross-platform and provide any necessary notes for running them on Linux, macOS, and Windows (e.g., differences in variable assignment syntax).
- Add PowerShell examples for Windows users and Bash examples for Linux/macOS users, or clarify that the provided CLI examples use Bash syntax.
- Mention and link to Azure Cloud Shell as a cross-platform, browser-based CLI option.
- Include a note or section confirming that all steps and tools are supported and tested on both Windows and Linux environments.
- Where GUI steps are described, clarify that the Azure Portal is accessible from any OS with a web browser.