Document Details
Plan At Scale Deployment
This page contains Windows bias
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
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation page demonstrates a moderate Windows bias. Windows and PowerShell are mentioned before Linux in several places, such as when creating a service principal ('using Azure PowerShell or from the Azure portal') and in onboarding scripts. There is a lack of explicit Linux command-line or automation tool examples (e.g., Bash, SSH, Ansible), and no Linux-specific tooling or patterns are highlighted. Most examples and instructions are either generic or Windows/PowerShell-centric, with Linux only referenced as an afterthought or in combined links.
Recommendations
- Provide explicit Linux command-line examples (e.g., Bash scripts, CLI commands) alongside PowerShell and portal instructions.
- Mention Linux automation tools (e.g., Ansible, Chef, Puppet) as options for deploying the Connected Machine agent.
- Ensure that Linux is referenced equally or first in lists and examples, not only as a secondary option.
- Include troubleshooting and management instructions specific to Linux environments (e.g., systemd service management, log file locations).
- Highlight Linux-specific considerations (e.g., package managers, SELinux/AppArmor, root permissions) where relevant.
Create Pull Request