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:
⚠️
windows_first
⚠️
powershell_heavy
⚠️
windows_tools
Summary:
The documentation provides both Azure CLI and Azure PowerShell examples for all operations, but PowerShell is given equal prominence to CLI, and the 'Next steps' section exclusively promotes a PowerShell-based tutorial. PowerShell is a Windows-centric tool, and there is no mention of Linux-specific considerations or examples (e.g., Bash scripting, Linux shell nuances), nor is there any guidance for Mac/Linux users. The documentation implicitly assumes familiarity with Windows/PowerShell environments.
Recommendations:
- In the 'Next steps' section, offer both CLI-based and PowerShell-based tutorials, or default to CLI (which is cross-platform) to avoid Windows bias.
- Explicitly mention that Azure CLI commands work on Windows, Linux, and macOS, and consider including Bash script examples or notes for Linux/Mac users.
- Clarify that PowerShell Core is cross-platform, but note that many users on Linux/macOS may prefer CLI or Bash.
- Add a brief section or note for Linux/macOS users, highlighting any differences or confirming that the steps are fully supported on those platforms.
- Ensure that CLI examples are presented first, as it is the most universally accessible tool, and consider de-emphasizing PowerShell unless there is a Windows-specific audience.
Create pull request