Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation demonstrates a notable Windows bias. Examples and instructions frequently reference Windows-specific tools (PowerShell, Kudu, App Service Editor, Windows-only portal features) and provide PowerShell examples alongside Azure CLI, but do not offer Linux/macOS shell equivalents or clarify cross-platform differences. Windows features and limitations are often discussed first or exclusively, while Linux support is limited, deprecated, or omitted, especially for plan migration and in-portal development. Some features are marked as Windows-only, and Linux users are directed to local development or CLI without parity in portal tooling.
Recommendations
- Provide explicit Linux/macOS shell examples (e.g., Bash) where PowerShell is used, especially for scripting and automation.
- Clarify which Azure CLI commands work identically on Linux/macOS and note any platform-specific caveats.
- Add instructions or alternatives for Linux users when features (Kudu, App Service Editor, portal console) are Windows-only or unavailable.
- Reorder examples to present cross-platform (CLI) solutions before Windows-specific tools.
- Clearly indicate feature availability and limitations for Linux/macOS in each relevant section, and link to Linux-specific guidance where available.
- Where plan migration is not supported on Linux, provide alternative strategies or workarounds for Linux users.
Create Pull Request