Bias Analysis
Detected Bias Types
powershell_heavy
missing_linux_example
windows_tools
windows_first
Summary
The documentation page demonstrates a bias towards Windows environments by exclusively providing PowerShell examples for command-line operations, referencing Windows-specific tools and patterns (e.g., PowerShell, Azure PowerShell modules, execution policy), and omitting equivalent Linux/Unix shell (e.g., Bash, CLI) examples. Windows terminology and tools are mentioned first or exclusively, with no guidance for Linux users on how to perform the same tasks using Bash, Azure CLI, or other cross-platform tools.
Recommendations
- Add equivalent Azure CLI (az) examples for all PowerShell cmdlets, showing how to create, view, edit, and delete endpoints using Bash or other shells.
- Include installation instructions for Azure CLI on Linux and macOS, alongside PowerShell instructions.
- Explicitly mention cross-platform compatibility and provide guidance for Linux/Unix users where Windows-specific concepts (e.g., execution policy) are referenced.
- Ensure screenshots and UI instructions do not assume a Windows environment (e.g., avoid references to Windows-only features or terminology).
- Where file system concepts differ (e.g., NTFS vs. POSIX), clarify the Linux/Unix equivalents and migration implications.
Create Pull Request