Bias Analysis
Detected Bias Types
windows_first
windows_tools
powershell_heavy
missing_linux_example
Summary
The documentation page exhibits several signs of Windows bias. Windows-specific paths (e.g., %HOME%, D:\home\site\wwwroot) and terminology are used throughout, often without Linux equivalents or with Linux information presented secondarily. Examples for file exclusion and backup filtering use Windows-style paths and drive letters. The Kudu DebugConsole and FTP upload instructions reference Windows file systems. While Azure CLI is cross-platform, PowerShell is mentioned as a scripting option without equivalent Bash or Linux shell samples. The documentation does not provide Linux/macOS-specific instructions or examples for tasks like file uploads, path references, or scripting, which may create friction for non-Windows users.
Recommendations
- Provide Linux/macOS equivalents for all file paths and commands (e.g., /home/site/wwwroot instead of D:\home\site\wwwroot).
- Include Bash or Linux shell script samples alongside PowerShell examples.
- Clarify instructions for uploading files using Linux/macOS tools (e.g., SCP, SFTP, or Azure CLI).
- Present cross-platform examples together, or alternate which OS is shown first.
- Explicitly state when instructions are OS-agnostic and when OS-specific steps are required.
Create Pull Request