Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
missing_linux_example
Summary
The documentation page demonstrates a strong Windows bias by exclusively using PowerShell scripts and referencing the Azure Portal/Azure Shell (which defaults to PowerShell) for configuration steps. There are no Bash or Linux shell script examples, and the instructions assume use of Windows-centric tools and environments. Azure CLI is mentioned, but only for a few steps, and even then, the context is still within the Azure Shell, which is often used from Windows. There is no guidance for Linux users, nor are Linux-native patterns or tools discussed.
Recommendations
- Provide equivalent Bash/Linux shell script examples for all PowerShell scripts, especially for steps involving Microsoft Graph and service principal configuration.
- Explicitly mention that Azure Cloud Shell can be used in Bash mode and provide instructions for switching to Bash.
- Include guidance for running these steps on Linux/macOS environments, including installation and usage of Azure CLI and Microsoft Graph CLI.
- Where possible, use cross-platform tools (e.g., Azure CLI, Microsoft Graph CLI) in examples before PowerShell, or at least provide both side-by-side.
- Add notes or sections highlighting any differences or additional steps required for Linux users.
Create Pull Request