Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation is generally cross-platform in its use of the Azure CLI, but it introduces a Windows/Powershell bias in the example for passing parameters to the CLI. The example uses Powershell variable assignment syntax ($params = ...) and single quotes for JSON, which is not valid in Bash or other Unix shells. There are no equivalent Linux/Bash examples, and the only variable assignment shown is in Powershell style, which may confuse Linux/macOS users.
Recommendations
- Provide both Windows (Powershell) and Linux/macOS (Bash) examples for passing parameters to the Azure CLI, especially for JSON strings and file references.
- Explicitly note shell differences when showing variable assignment or command usage that is shell-dependent.
- Use cross-platform compatible syntax where possible, or clearly label examples as 'Windows (Powershell)' and 'Linux/macOS (Bash)'.
- Add a Bash example for parameter passing, e.g., params='{"name": "firstMsi", "location": "northeurope"}' and use $params in the CLI command.
- Review for any other CLI usage patterns that may differ between shells and ensure parity in documentation.
Create Pull Request