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 demonstrates a Windows bias by defaulting to Windows as the operating system for the cluster, providing certificate creation instructions exclusively via a PowerShell script (.ps1), and referencing Windows tools (PowerShell, Notepad) without Linux equivalents. There are no Linux-specific instructions or examples for certificate creation or cluster setup, and the process for Linux users is not addressed.
Recommendations:
- Provide parallel instructions for Linux users, including how to generate the required certificate using common Linux tools (e.g., OpenSSL) and how to supply the certificate information.
- Include Linux shell (bash) command examples alongside PowerShell examples for all relevant steps.
- Explicitly mention that both Windows and Linux are supported, and clarify any differences in setup or requirements.
- Avoid defaulting to Windows in UI screenshots and instructions; instead, show both options or clarify that the default can be changed.
- Reference Linux text editors (e.g., nano, vim) or platform-agnostic methods for viewing output files, rather than only Notepad.
Create pull request