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 toward Windows and PowerShell usage. All examples and instructions use Azure PowerShell cmdlets and Windows-specific tools (such as New-SelfSignedCertificate and Export-PfxCertificate), with no mention of Bash, Azure CLI, or Linux/macOS equivalents. The tutorial assumes a Windows environment (e.g., file paths like c:\appgwcert.pfx), and does not provide alternative instructions for Linux or cross-platform users.
Recommendations:
- Provide equivalent Azure CLI (az) commands for each step, as Azure CLI is cross-platform and widely used on Linux/macOS.
- Include instructions for generating self-signed certificates using OpenSSL, which is available on all platforms, not just New-SelfSignedCertificate (Windows-only).
- Use platform-agnostic file paths or note differences (e.g., c:\appgwcert.pfx vs. ~/appgwcert.pfx).
- Explicitly mention that the tutorial can be followed on Linux/macOS and provide any required adjustments.
- Add a section or callouts for Linux/macOS users, including how to install and use Azure PowerShell or Azure CLI on those platforms.
- Consider providing a toggle or tabs for PowerShell and Azure CLI/Bash examples throughout the tutorial.
Create pull request