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
⚠️
powershell_heavy
⚠️
windows_tools
Summary:
The documentation provides both Linux and Windows instructions for most steps, but there is a slight Windows bias in the ordering and presentation. Windows examples and tools (such as PowerShell and Windows-specific storage/file share instructions) are sometimes presented before or more prominently than their Linux equivalents. Some CLI scripts assume a Windows shell environment, and there is heavier use of Windows terminology and tools (e.g., references to Azure Files, Windows environment variables, and PowerShell-style scripting). However, Linux parity is generally good, with dedicated Linux tabs and instructions throughout.
Recommendations:
- Ensure Linux and Windows instructions are always presented in parallel, with neither consistently preceding the other.
- Where possible, provide Bash and PowerShell script examples side-by-side, or clarify which shell is assumed.
- Avoid Windows-centric terminology when describing cross-platform features (e.g., refer to 'file shares' generically, not just 'Azure Files').
- Explicitly mention required tools for both platforms (e.g., jq for Linux, PowerShell equivalents for Windows).
- Audit all CLI scripts for shell compatibility and provide both Bash and PowerShell variants where needed.
- Review and balance the use of screenshots or UI references from both Windows and Linux environments.
- Highlight any platform-specific limitations or differences up front, so users can quickly identify relevant sections.
Create pull request