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
Summary:
The documentation provides both Bash and PowerShell examples for Azure CLI commands, but PowerShell syntax is consistently presented immediately after Bash, and sometimes with explicit 'PowerShell syntax' labels. There are no Windows-only tools or exclusive PowerShell-only steps, but the repeated inclusion and labeling of PowerShell examples may give the impression of Windows being a primary or preferred platform. All tooling (Azure CLI, azd, Visual Studio Code) is cross-platform, but the documentation does not explicitly highlight Linux or macOS parity, nor does it provide Linux-specific troubleshooting or environment notes.
Recommendations:
- Alternate the order of Bash and PowerShell examples to avoid always presenting Bash first, or clarify that both are equally supported.
- Explicitly mention that all tools and steps are cross-platform, and provide links or notes for Linux/macOS users where relevant (e.g., VS Code installation, azd installation).
- Add a short section or note confirming that the workflow is fully supported on Linux and macOS, including any known differences or tips for those environments.
- Where possible, include screenshots or terminal output from Linux/macOS environments, not just Windows/PowerShell.
- If there are any platform-specific caveats (e.g., file path syntax, permissions), call them out directly.
Create pull request