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
⚠️
missing_linux_example
Summary:
The documentation generally aims for cross-platform coverage, but there are several instances of Windows bias. Windows-specific tools, patterns, and terminology (such as environment variable delimiters, file paths, and settings) are often mentioned first or exclusively. PowerShell is referenced in detail, while equivalent Linux shell or Bash examples are missing. Some settings are described as 'Windows only' without parallel Linux guidance, and certain examples (like file paths) use Windows conventions. In a few cases, Linux-specific instructions are present but less prominent or detailed.
Recommendations:
- For every Windows-specific example or mention (such as environment variable delimiters, file paths, or settings), provide the Linux equivalent side-by-side or in parallel.
- When referencing PowerShell or Windows tools, also mention and give examples for Bash or Linux CLI usage.
- Avoid using Windows paths (e.g., %HOME%\typescript) without also showing the Linux alternative (e.g., $HOME/typescript).
- Where settings or behaviors differ between Windows and Linux (such as environment variable delimiters or time zone values), clearly document both, not just the Windows case.
- If a setting is 'Windows only', explicitly state what the Linux equivalent is or clarify if there is none.
- Ensure that Linux-specific features (such as linuxFxVersion, Oryx build, etc.) are given equal prominence and detail as Windows-specific features.
- Add Bash/Azure CLI examples wherever Azure PowerShell is referenced for managing settings.
Create pull request