Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
missing_linux_example
windows_first
Summary
The documentation page exhibits a strong Windows bias, primarily by providing PowerShell-only examples and referencing Windows-centric tools and workflows (PowerShell cmdlets, Visual Studio) without mentioning or demonstrating equivalent Linux/macOS approaches (such as Azure CLI, REST API, or cross-platform SDKs). There are no Linux/macOS shell examples, and the guidance assumes familiarity with Windows tooling, which may hinder non-Windows users.
Recommendations
- Add equivalent Azure CLI and/or REST API examples for all PowerShell cmdlets mentioned, especially for service creation, updates, and upgrades.
- Explicitly mention cross-platform alternatives (e.g., Azure CLI, .NET SDK, REST API) and link to their documentation.
- Provide sample commands for Linux/macOS environments (bash, CLI) alongside PowerShell examples.
- Clarify which features or tools are available cross-platform and note any limitations.
- Include a section on upgrading applications using Linux/macOS, with step-by-step instructions.
Create Pull Request