Bias Analysis
Detected Bias Types
windows_tools
windows_first
missing_linux_example
Summary
The documentation page demonstrates a Windows bias by exclusively referencing Windows-centric tools (Visual Studio, Azure Storage Explorer) and patterns, and by omitting Linux-specific instructions or alternatives. Visual Studio and its extensions are mentioned as primary map creation tools, with no mention of Linux-native equivalents. Azure Storage Explorer is referenced for blob management, but no CLI or Linux-friendly alternatives are provided. The documentation assumes a GUI workflow typical of Windows environments and does not provide parity for Linux users.
Recommendations
- Include Linux-native instructions for map creation and management, such as using VS Code on Linux or cross-platform CLI tools.
- Provide examples for uploading assemblies and maps using Azure CLI, PowerShell (cross-platform), or REST API, especially for Linux users.
- Mention alternative tools for blob management, such as azcopy or Azure CLI, and provide step-by-step instructions for Linux.
- Clarify that Visual Studio Code is cross-platform and provide explicit instructions for installing and using the Data Mapper extension on Linux.
- Add notes or sections highlighting any differences or considerations for Linux/macOS users throughout the documentation.
- Where screenshots are used, include examples from Linux desktops or clarify that the steps are applicable across platforms.
Create Pull Request