Document Details
Samples Bicep
❌
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
Bias Types:
⚠️
windows_first
⚠️
windows_tools
⚠️
missing_linux_example
Summary:
The documentation page shows some evidence of Windows bias. Windows-specific samples (such as 'basic Windows app', 'Windows container app', and 'App with MySQL on Windows') are present and sometimes precede or are more detailed than Linux equivalents. There is also a lack of parity in certain scenarios: for example, there is a sample for 'App with MySQL on Windows' but not for Linux, and Windows containers are mentioned without a Linux container counterpart. Additionally, the documentation does not provide Linux-specific tools, patterns, or examples where relevant.
Recommendations:
- Ensure that for every Windows-specific sample (e.g., Windows app, Windows container, MySQL on Windows), there is a corresponding Linux sample (e.g., Linux app, Linux container, MySQL on Linux).
- Present Linux and Windows examples in parallel or alternate their order to avoid always listing Windows first.
- Add explicit Linux container deployment samples to match the Windows container example.
- Where possible, mention cross-platform tools and avoid referencing only Windows-specific tools or patterns.
- Review all scenarios to ensure Linux users have equivalent guidance and sample coverage.
Create pull request