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_first
⚠️
windows_tools
⚠️
missing_linux_example
Summary:
The documentation demonstrates a Windows bias by providing detailed PowerShell examples, referencing Windows-specific tools (e.g., dig.exe), and omitting explicit Linux/Bash examples. The CLI section uses Azure CLI, which is cross-platform, but sample commands and tool references (like dig.exe) are Windows-centric. There are no Linux shell or Bash examples, and the documentation does not mention Linux-specific patterns or tools, nor does it clarify cross-platform compatibility for commands.
Recommendations:
- Add explicit Linux/Bash shell examples for all command-line steps, especially for obtaining DS records and using tools like dig (e.g., show 'dig' usage in Linux, not just 'dig.exe').
- Replace references to 'dig.exe' with 'dig', and clarify that 'dig' is available on both Windows and Linux, providing installation instructions if needed.
- In CLI sections, show both Windows (cmd/PowerShell) and Linux (bash) command syntax where differences exist.
- Ensure that any PowerShell-specific instructions are accompanied by equivalent Bash or Linux shell instructions.
- Mention that Azure CLI is cross-platform and can be used on Linux, macOS, and Windows, and provide links to installation guides for each OS.
- Where screenshots or UI steps are shown, clarify that the Azure Portal is OS-agnostic.
- Review the order of examples: consider presenting cross-platform or Linux examples before or alongside Windows/PowerShell examples to avoid 'windows_first' bias.
Create pull request