Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
missing_linux_example
Summary
The documentation page demonstrates a strong bias toward Windows and PowerShell environments. All command-line examples for certificate management use PowerShell cmdlets, with no equivalent Bash, Azure CLI, or Linux-native instructions. Windows/PowerShell tools and patterns (e.g., .pfx, ConvertTo-SecureString, X509Certificate2) are referenced exclusively, and PowerShell is presented before Python in both explanations and examples. There are no Linux shell or cross-platform CLI examples for certificate creation, upload, or retrieval.
Recommendations
- Provide Azure CLI examples for certificate management tasks (creation, upload, retrieval) alongside PowerShell examples.
- Include Bash or shell script examples for common certificate operations, especially for Linux users.
- Mention Linux-compatible certificate formats and tools (e.g., OpenSSL) and show how to prepare/upload certificates from Linux environments.
- Reorder or parallelize sections so that PowerShell and cross-platform (CLI, Python) examples are presented with equal prominence.
- Clarify that the PowerShell cmdlets can be used on Linux/macOS via PowerShell Core, if applicable, or provide alternatives.
- Reference Linux-native certificate stores and how to use certificates managed by Azure Automation in Linux-based runbooks or DSC configurations.
Create Pull Request