Detected Bias Types
Windows First
🔧
Windows Tools
Missing Linux Example
Summary
The documentation page for Azure Cloud Services (extended support) WebRole schema demonstrates a Windows bias. The schema and examples are heavily oriented around Windows technologies, particularly IIS 7, ASP.NET, and Windows-specific concepts such as certificate stores ('CurrentUser', 'LocalMachine', 'My', etc.), environment variables, and startup tasks using CMD/batch files. There are no examples or mentions of Linux equivalents, nor any guidance for deploying non-Windows workloads or using Linux-based tools. The documentation assumes a Windows environment and does not provide parity for Linux users.
Recommendations
- Add explicit guidance or examples for deploying web roles using Linux-based runtimes (e.g., NGINX, Apache, Node.js) where supported.
- Include Linux equivalents for certificate management, such as referencing PEM files, OpenSSL, or Linux trust stores.
- Provide examples of startup tasks using shell scripts (.sh) and note encoding requirements for Linux (UTF-8, etc.).
- Clarify which schema elements and features are Windows-only, and which (if any) are supported on Linux web roles.
- Reference cross-platform development patterns and tools, and link to Linux-specific documentation where available.
- If Linux web roles are not supported, explicitly state this limitation to set user expectations.