Bias Analysis
Detected Bias Types
windows_first
windows_tools
missing_linux_example
Summary
The documentation is heavily oriented toward Windows environments, referencing IIS 7, ASP.NET, Windows Communication Foundation, and Windows-specific concepts (such as certificate stores and environment variables). All examples and schema elements assume Windows tooling and patterns, with no mention of Linux equivalents or cross-platform support. There are no Linux/macOS-specific instructions, examples, or clarifications, and Windows terminology (IIS, CMD files, certificate store names) is used exclusively.
Recommendations
- Explicitly state platform limitations: If web roles are Windows-only, clarify this early in the documentation.
- Add Linux/macOS parity notes: If Linux is supported, provide equivalent instructions, examples, and tooling for Linux environments (e.g., Apache/Nginx, Linux certificate stores, shell scripts).
- Include cross-platform startup task examples: Show how startup tasks can be implemented using shell scripts (.sh) for Linux, not just CMD files for Windows.
- Clarify certificate management: Explain how certificates should be handled on Linux (e.g., location, store names, permissions).
- Mention alternative web server support: If only IIS is supported, state this clearly; if Linux web servers are supported, provide configuration guidance.
- Reorder examples or add parity: Avoid always listing Windows tools/patterns first; provide Linux/macOS examples side-by-side.
Create Pull Request