Document Details
Troubleshooting
❌
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
Bias Types:
⚠️
windows_first
⚠️
windows_tools
⚠️
missing_linux_example
Summary:
The documentation demonstrates a Windows bias by referencing Windows tools and patterns first or exclusively. It mentions that a secure FTP client is installed on most typical Windows instances, and recommends WinRAR (a Windows tool) for extracting Zstandard archives, without mentioning Linux equivalents. There are no explicit Linux command examples or tool recommendations, and the documentation assumes a Windows-centric environment for host operations.
Recommendations:
- Explicitly mention and provide examples for both Windows and Linux environments when discussing prerequisites and tools (e.g., recommend FileZilla or lftp for Linux as secure FTP clients).
- Suggest Linux-native tools for extracting Zstandard archives, such as 'tar' with 'zstd' or the 'unzstd' command, alongside WinRAR.
- Include example commands for retrieving and extracting the support bundle on Linux hosts, not just Windows.
- Avoid language that assumes the user is on Windows (e.g., 'A secure FTP client is installed on most typical Windows instances') and instead provide parity for both platforms.
- Where screenshots or command snippets are shown, provide both Windows and Linux variants if the process differs.
Create pull request