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:
⚠️
powershell_heavy
⚠️
windows_tools
⚠️
missing_linux_example
⚠️
windows_first
Summary:
The documentation is heavily biased towards Windows and PowerShell usage. All examples use Azure PowerShell cmdlets and Windows-specific tools (such as New-SelfSignedCertificate and Export-PfxCertificate), with no mention of Bash, Azure CLI, or Linux-compatible alternatives. The instructions assume a Windows environment (e.g., file paths like c:\appgwcert.pfx), and there are no parallel Linux or cross-platform examples provided.
Recommendations:
- Provide equivalent Azure CLI (az) command examples alongside PowerShell for each step, as Azure CLI is cross-platform and widely used on Linux and macOS.
- For certificate creation, include Linux/macOS instructions using OpenSSL to generate self-signed certificates and export to .pfx format.
- Use platform-agnostic file paths (e.g., ./appgwcert.pfx) or clarify when a path is OS-specific.
- Explicitly state that the tutorial can be followed from Windows, Linux, or macOS, and provide prerequisites and setup instructions for each OS.
- Where PowerShell is required, mention PowerShell Core (pwsh), which is cross-platform, and provide guidance for installing and running it on Linux/macOS.
- Add a section or callouts for users who prefer Bash scripting or other shells, referencing relevant documentation.
Create pull request