Detected Bias Types
Windows First
Powershell Heavy
Missing Linux Example
Summary
The documentation demonstrates a Windows bias in several ways. In the 'Manual failover' section, the Azure portal (GUI), Azure CLI, Azure PowerShell, and C# are presented as options. PowerShell (a Windows-centric tool) is given its own section, and C# (commonly associated with Windows development) is highlighted with sample code. There are no explicit Linux shell (bash) or scripting examples, nor are Linux-specific tools or workflows mentioned. The CLI example is present, but there is no demonstration of usage in a Linux environment, nor are Linux-specific considerations or parity discussed. The ordering of examples (portal, CLI, PowerShell, C#) also places Windows-centric tools before cross-platform or Linux-native approaches.
Recommendations
- Add explicit bash/Linux shell examples for CLI commands, including sample output and error handling.
- Include Linux-specific instructions or screenshots for Azure CLI usage, especially for failover operations.
- Mention Linux-native automation tools (e.g., shell scripts, cron jobs) for automating failover.
- Ensure parity by providing examples in Python or JavaScript (cross-platform languages) alongside C#.
- Reorder the example sections to present CLI (cross-platform) before PowerShell (Windows-centric).
- Explicitly state that all CLI commands work on Linux, macOS, and Windows, and provide troubleshooting tips for Linux users.