About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
Bias Types:
⚠️
powershell_heavy
⚠️
windows_first
⚠️
missing_linux_example
Summary:
The documentation provides both PowerShell and Azure CLI examples for creating service principals, but PowerShell is presented first and is described as being tested in Visual Studio Code, which is more common on Windows. There is no explicit mention or example of running these commands on Linux or macOS, nor are there any notes about differences or prerequisites for non-Windows environments. The documentation implicitly assumes a Windows-centric workflow.
Recommendations:
- Provide explicit examples or notes for running Azure CLI commands on Linux/macOS, including any differences in environment variables or shell syntax.
- Alternate the order of PowerShell and CLI examples, or present CLI examples first, as Azure CLI is cross-platform.
- Mention that Visual Studio Code and Azure CLI are available on all major platforms, and clarify that the CLI commands work on Linux and macOS.
- Add a brief section or note about prerequisites or setup for Linux/macOS users, such as installing Azure CLI and using bash/zsh.
- Where possible, avoid assuming the use of PowerShell or Windows-specific tools unless necessary, and provide parity in instructions for all platforms.
Create pull request