Document Details
Service Fabric Best Practices
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
Detected Bias Types
powershell_heavy
windows_first
windows_tools
missing_linux_example
Summary
The documentation page demonstrates a notable Windows bias. It repeatedly references Windows-specific tools (PowerShell module, Windows Server certificate service, MakeCert.exe), and Windows security mechanisms. Examples and instructions for cluster creation, certificate management, and automation are focused on Windows and PowerShell, with no Linux or cross-platform command-line examples. Windows terminology and tools are mentioned first or exclusively, and there is little to no guidance for Linux/macOS users on how to perform equivalent tasks.
Recommendations
- Provide equivalent Linux/macOS examples for cluster creation, management, and automation (e.g., using Azure CLI, Bash scripts, or cross-platform tools).
- Mention and demonstrate Linux-compatible certificate creation and management tools (e.g., OpenSSL) alongside Windows Server certificate service and MakeCert.exe.
- Clarify which features and instructions apply to Linux-based Service Fabric clusters, and offer links to Linux-specific documentation where available.
- Avoid using Windows terminology (e.g., 'Remote Desktop Connection', 'Active Directory') without noting Linux alternatives (e.g., SSH, LDAP).
- Ensure that cross-platform APIs (REST, ARM templates) are highlighted as primary automation mechanisms, with PowerShell as an option rather than the default.
Create Pull Request
Scan History
| Date | Scan | Status | Result |
|---|---|---|---|
| 2026-01-14 00:00 | #250 | in_progress |
Biased
|
| 2026-01-13 00:00 | #246 | completed |
Biased
|
| 2026-01-11 00:00 | #240 | completed |
Biased
|
| 2026-01-10 00:00 | #237 | completed |
Biased
|
| 2026-01-09 00:34 | #234 | completed |
Biased
|
| 2026-01-08 00:53 | #231 | completed |
Biased
|
| 2026-01-06 18:15 | #225 | cancelled |
 Clean
|
| 2025-08-17 00:01 | #83 | cancelled |
Clean
|
| 2025-07-13 21:37 | #48 | completed |
Clean
|
| 2025-07-12 23:44 | #41 | cancelled |
Biased
|