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
⚠️
missing_linux_example
Summary:
The documentation provides both Azure CLI (with Bash scripting) and PowerShell examples for managing deployment history. However, the PowerShell section is presented after the Azure CLI section, but the CLI examples assume a Bash environment without explicitly mentioning Windows Command Prompt or PowerShell Core on Windows. There is no explicit Windows-only tool, but the Bash scripting in the CLI section may not work natively on Windows without WSL or similar. The PowerShell examples are Windows-centric and do not mention cross-platform PowerShell Core usage. There are no Command Prompt (cmd.exe) examples, and Linux users are only supported via Bash scripting, which is not explicitly clarified as Linux/macOS or WSL on Windows.
Recommendations:
- Explicitly state that the Azure CLI Bash examples are intended for Linux/macOS or WSL on Windows, and provide equivalent examples for Windows Command Prompt or PowerShell Core if possible.
- Clarify that PowerShell examples can be used on both Windows PowerShell and cross-platform PowerShell Core.
- Consider providing a table or section that summarizes which commands/scripts are suitable for which platforms (Windows, Linux, macOS).
- Add notes or links for users on how to run Bash scripts on Windows (e.g., via WSL, Git Bash, or Cygwin) if they are using Azure CLI.
- Ensure parity by including examples for all major platforms or by clearly indicating platform requirements for each example.
Create pull request