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:
⚠️
windows_first
⚠️
windows_tools
⚠️
powershell_heavy
⚠️
missing_linux_example
Summary:
The documentation exhibits a Windows-first bias in several ways: Windows paths and deployment patterns are consistently mentioned before Linux equivalents, and Windows-specific folders (e.g., c:\home\data\SitePackages) are referenced throughout. There is a lack of Linux-specific command-line or shell examples, and no Linux-native tooling or deployment workflows are highlighted. The documentation assumes familiarity with Windows conventions and tools, with only minimal parity for Linux mentioned as afterthoughts.
Recommendations:
- Present Linux and Windows instructions/examples side by side or in parallel sections, rather than always listing Windows first.
- Include Linux-native command-line examples (e.g., bash, zip, scp, az CLI on Linux) for creating and deploying packages.
- Reference Linux paths first or equally, and avoid assuming Windows as the default environment.
- Highlight Linux-specific deployment considerations and tools (such as using Linux shells, permissions, or automation scripts).
- Provide explicit Linux troubleshooting steps and examples, not just Windows-centric advice.
- Where UI steps are described, mention any differences for Linux users (e.g., Azure CLI vs. Azure Portal).
Create pull request