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
⚠️
windows_tools
⚠️
missing_linux_example
Summary:
The documentation demonstrates a moderate Windows bias. Windows-based deployment options (such as source control, Local Git, and FTPS) are called out as 'Windows-only' in the technology availability table, while Linux equivalents are either less emphasized or described as limited. Windows-specific tools and patterns (e.g., Visual Studio, Kudu/SCM site) are mentioned first or in more detail, and some deployment methods (like source control and FTPS) are not available or are restricted on Linux. Linux-specific instructions are present but often secondary, and there are few Linux command-line or native tool examples.
Recommendations:
- Provide Linux-first or Linux-parity examples for each deployment method, especially where Windows is called out as the default or primary platform.
- Where deployment technologies are Windows-only, offer clear Linux alternatives or workarounds, and link to relevant Linux documentation.
- Include more explicit Linux command-line examples (e.g., Bash, native Linux tools) alongside or before Windows/PowerShell/Visual Studio instructions.
- Clarify any limitations or differences for Linux users up front, and avoid presenting Windows tools as the default unless truly universal.
- Expand documentation on remote build and deployment for Linux, including troubleshooting and best practices.
- Where possible, avoid using 'Windows-only' as a default and instead structure tables and sections to give Linux and Windows equal prominence.
Create pull request