Document Details
Deploy Best Practices
This page contains Windows bias
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
Detected Bias Types
windows_first
windows_tools
missing_linux_example
Summary
The documentation demonstrates a subtle Windows bias by referencing Windows-specific tools (such as WebDeploy and Kudu's Windows process) before or more prominently than their Linux equivalents. There is a lack of explicit Linux command-line examples (e.g., SCP, SFTP, rsync) for deployment, and the documentation does not provide parity in describing Linux-native workflows or tools. The Kudu section describes its operation on Windows in more detail than on Linux. WebDeploy, a Windows-centric tool, is mentioned without Linux alternatives. No Linux shell or cross-platform deployment examples are provided outside of the GitHub Actions YAML, which is generic.
Recommendations
- Add explicit Linux-native deployment examples (e.g., using SCP, SFTP, rsync, or Azure CLI from a Linux shell) alongside or before Windows tools.
- Clarify Kudu's operation on both Windows and Linux App Service plans, giving equal detail for both.
- When mentioning WebDeploy (a Windows tool), also mention and provide guidance for Linux users (e.g., using FTP, Azure CLI, or other cross-platform tools).
- Provide sample deployment commands/scripts for both PowerShell/Windows CMD and Bash/Linux shell.
- Review the order of tool presentation to avoid always listing Windows tools or patterns first.
- Where possible, use neutral, cross-platform language and examples, or explicitly call out differences and options for both Windows and Linux users.
Create Pull Request
Scan History
| Date | Scan | Status | Result |
|---|---|---|---|
| 2026-01-14 00:00 | #250 | in_progress |
 Clean
|
| 2026-01-13 00:00 | #246 | completed |
Clean
|
| 2026-01-12 00:00 | #243 | cancelled |
Clean
|
| 2026-01-11 00:00 | #240 | completed |
Clean
|
| 2026-01-10 00:00 | #237 | completed |
Clean
|
| 2026-01-09 00:34 | #234 | completed |
Clean
|
| 2026-01-08 00:53 | #231 | completed |
Clean
|
| 2026-01-08 00:00 | #228 | cancelled |
Clean
|
| 2026-01-06 18:15 | #225 | cancelled |
Clean
|
| 2025-09-15 00:00 | #112 | completed |
Biased
|
| 2025-08-15 00:01 | #81 | cancelled |
Biased
|
| 2025-07-13 21:25 | #47 | cancelled |
Biased
|
| 2025-07-13 20:48 | #44 | cancelled |
Clean
|
| 2025-07-09 13:09 | #3 | cancelled |
Clean
|
| 2025-07-08 04:23 | #2 | cancelled |
Biased
|