Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation page demonstrates a Windows bias in several ways. Powershell is used exclusively for all command-line examples, with no equivalent Bash, Azure CLI, or Linux-native instructions provided. Windows-centric tools and patterns (e.g., Windows file paths, certificate store references) are present in code samples and explanations. Sample templates and migration walkthroughs reference Windows first, and Linux-specific guidance is missing or relegated to links without direct examples. This may hinder Linux users attempting similar migrations.
Recommendations
- Provide equivalent Azure CLI and Bash examples for all Powershell commands, especially for cluster migration, node disabling, and resource management.
- Include Linux-specific instructions and code samples, such as handling certificates, file paths, and Service Fabric management on Ubuntu or other supported distributions.
- Reference both Windows and Linux sample templates equally, and ensure that links to Linux templates are accompanied by direct, in-page examples.
- Avoid Windows-centric terminology (e.g., Windows file paths, certificate store names) in generic instructions, or provide Linux alternatives side-by-side.
- Explicitly state platform differences and requirements in the prerequisites and migration steps, so users on Linux are aware of necessary adaptations.
Create Pull Request