Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation page demonstrates a moderate Windows bias. Windows tools and patterns (such as Azure PowerShell and Windows Failover Cluster) are mentioned before or alongside Linux equivalents, and Windows-specific scenarios are described in detail. While Linux is referenced (especially SUSE and Red Hat), examples and operational instructions often default to Windows-first or PowerShell-heavy approaches, with Linux-specific guidance sometimes relegated to linked documents or notes. There are few explicit Linux command-line examples, and some operational steps (e.g., VM deployment, network configuration) mention PowerShell before Azure CLI or Linux-native methods.
Recommendations
- Ensure Linux CLI (bash, Azure CLI) examples are provided alongside or before PowerShell examples for all operational steps.
- Where Windows-specific tools or patterns (e.g., Windows Failover Cluster, SOFS) are described, provide equal detail for Linux equivalents (e.g., Pacemaker, SBD).
- Add explicit Linux command-line examples for common tasks such as VM deployment, storage configuration, and network setup.
- Review all sections for Windows-first ordering and alternate with Linux-first or neutral ordering.
- Clarify when instructions are OS-specific, and avoid assuming Windows as the default unless justified by usage statistics.
- Expand troubleshooting and backup/restore sections to include Linux-native tools and workflows.
Create Pull Request