Bias Analysis
Detected Bias Types
windows_first
windows_tools
missing_linux_example
Summary
The documentation page exhibits a Windows bias in several areas. Windows operating systems and related artifacts (e.g., Windows VM, Windows VMSS, Active Directory Domain Services) are mentioned before or more prominently than Linux equivalents. The default value for the jumpbox operating system is set to Windows, and there is a strong focus on Windows-centric infrastructure components (Active Directory, domain admin accounts, etc.). While some Linux-specific artifacts are present (e.g., Log Analytics Agent for Linux VMs), there are no Linux-first examples or guidance, and Linux options are generally presented as secondary or optional.
Recommendations
- Provide Linux-first examples and guidance where applicable, such as setting the default jumpbox OS to Linux or offering parallel instructions for Linux-based deployments.
- Ensure that Linux VM and VMSS artifacts are described with equal detail and prominence as their Windows counterparts.
- Include explicit instructions or examples for configuring Linux authentication and management (e.g., SSH keys, Linux domain join alternatives) alongside Windows/Active Directory guidance.
- Review parameter tables and deployment steps to avoid defaulting to Windows unless required by the blueprint's compliance needs.
- Where Active Directory is referenced, mention alternatives for Linux environments (e.g., Azure AD, LDAP, or other identity solutions) if possible.
Create Pull Request