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
⚠️
powershell_heavy
Summary:
The documentation generally maintains cross-platform parity, but there are subtle Windows biases. Windows-specific instructions (such as .exe suffixes and use of 'set' in cmd) are often mentioned first or in more detail. The documentation refers to Windows conventions (e.g., 'handler.exe') before Linux ones, and Windows-specific build steps are called out with more explicit instructions. There is also a slight assumption of familiarity with Windows tools and patterns, such as referencing 'cmd' and using Windows-style environment variable setting. However, Linux and macOS instructions are present and correct, and the documentation does not omit Linux examples.
Recommendations:
- When referring to executable names, mention the Linux version first or present both equally (e.g., 'handler (Linux/macOS) or handler.exe (Windows)').
- Group platform-specific instructions together and avoid listing Windows first by default.
- For environment variable setting, provide cross-platform commands side by side (e.g., 'export' for Linux/macOS and 'set' for Windows), or use table/tabbed formatting.
- Avoid assuming Windows conventions (such as .exe suffix) as the default; clarify when each is needed.
- Where possible, use platform-agnostic language and tools, or clearly indicate when a step is platform-specific.
- Ensure that all screenshots and terminal outputs include Linux/macOS examples, not just Windows.
Create pull request