Document Details
Create Environment Service Fabric Cluster
❌
This page contains Windows bias
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
⚠️
missing_linux_example
⚠️
windows_tools
Summary:
The documentation displays a Windows bias in several ways: Windows is the default OS for cluster VMs, certificate creation instructions are provided only for PowerShell (with a .ps1 script), and there are no equivalent Linux/bash examples or references to Linux tooling for certificate management. The documentation mentions that clusters can be created on Linux or Windows, but all concrete steps and scripts are Windows-centric.
Recommendations:
- Provide Linux/bash equivalents for certificate creation, such as using OpenSSL, alongside the PowerShell example.
- Explicitly mention that the .ps1 script is for Windows and offer a Linux alternative or link to Linux instructions.
- When describing the OS selection, avoid making Windows the default or at least give equal prominence to Linux.
- Include screenshots or CLI steps that demonstrate the process on a Linux system where applicable.
- Reference Linux tools (e.g., bash, OpenSSL) in parallel with Windows tools (e.g., PowerShell, .ps1 scripts).
Create pull request