IoT
41
Total Pages
26
Linux-Friendly Pages
15
Pages with Bias
36.6%
Bias Rate
Bias Trend Over Time
Pages with Bias Issues
81 issues found
Showing 76-81 of 81 flagged pages
IoT
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/iot/howto-use-iot-explorer.md
...-docs/blob/main/articles/iot/howto-use-iot-explorer.md
Medium Priority
View Details →
Detected Bias Types
Windows First
Missing Linux Example
Summary
The documentation page for Azure IoT explorer subtly favors Windows by mentioning Windows-specific launch instructions (e.g., launching from the Start menu) without providing equivalent details for Linux or macOS. There are no explicit Linux or macOS installation or usage examples, nor are there references to platform-specific behaviors or troubleshooting for non-Windows users.
Recommendations
- Add explicit installation and launch instructions for Linux and macOS platforms, including how to run the application from the terminal or application menu.
- Include screenshots or examples from Linux and macOS environments to demonstrate parity.
- Mention any platform-specific prerequisites or troubleshooting steps for Linux/macOS users.
- Ensure that all steps and features described are clearly applicable to all supported platforms, or note any differences.
Create Pull Request
IoT
Introduction to Azure IoT device development
...b/main/articles/iot/concepts-iot-device-development.md
Low Priority
View Details →
Detected Bias Types
Windows Tools
Powershell Heavy
Windows First
Summary
The documentation page lists Windows-specific tools (PowerShell) alongside cross-platform options (CLI, VS Code, REST APIs), and includes PowerShell in the main tools table. While Linux-compatible tools are present, Windows tools are mentioned explicitly and given equal prominence, with no Linux/macOS-specific examples or tools highlighted. The order of tool presentation places Windows-centric options before Linux-native ones, and there are no explicit Linux/macOS command examples or tool recommendations.
Recommendations
- Add explicit Linux/macOS examples for common tasks (e.g., using Azure CLI on Linux, bash scripts).
- Mention Linux-native tools (such as bash, curl, or other relevant utilities) where appropriate.
- Clarify that Azure CLI and VS Code are cross-platform, and provide links or notes for Linux/macOS installation and usage.
- Consider reordering the tools table to list cross-platform options first, or group by platform compatibility.
- Add a note or section highlighting Linux/macOS development workflows and toolchains.
Low Priority
View Details →
Detected Bias Types
Windows Tools
Windows First
Summary
The documentation references both Azure CLI and PowerShell as alternatives to the management SDKs, but lists PowerShell before REST API and does not mention Linux-specific tools or provide parity in example ordering. There are no explicit Linux/macOS examples or tool recommendations, and PowerShell (a Windows-centric tool) is highlighted alongside Azure CLI, which is cross-platform.
Recommendations
- List Azure CLI before PowerShell, as CLI is cross-platform and more commonly used on Linux/macOS.
- Explicitly mention that Azure CLI and REST API are available and supported on Linux/macOS.
- Provide example commands for both Azure CLI and PowerShell, or link to Linux/macOS-specific guides.
- Add a note clarifying platform compatibility for each tool mentioned.
- Consider including links to Linux/macOS installation guides for Azure CLI.
Low Priority
View Details →
Detected Bias Types
Windows Tools
Windows First
Summary
The documentation mentions both Azure CLI and PowerShell as alternatives to management SDKs, but PowerShell is listed before REST API and is given equal prominence to Azure CLI. There are no explicit Linux/macOS examples or tool recommendations, and PowerShell (a Windows-centric tool) is referenced without clarifying cross-platform support. No Linux-specific tools or patterns are mentioned, and examples are not shown for either platform.
Recommendations
- List Azure CLI before PowerShell, as CLI is cross-platform and more commonly used on Linux/macOS.
- Clarify that PowerShell Core is available cross-platform, or link to platform-specific instructions.
- Provide explicit examples for both Windows (PowerShell) and Linux/macOS (Azure CLI, Bash).
- Mention Linux/macOS compatibility in relevant sections.
- Include links to Linux/macOS setup guides for SDKs and tools.
IoT
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/iot/iot-sdks.md
...softDocs/azure-docs/blob/main/articles/iot/iot-sdks.md
Low Priority
View Details →
Detected Bias Types
Windows First
Summary
The documentation lists both Azure CLI and PowerShell as alternatives to the management SDKs, but mentions Azure CLI first, followed by PowerShell and REST API. There are no explicit examples or instructions that are Windows- or PowerShell-specific, and no exclusive mention of Windows tools or patterns. However, the inclusion of PowerShell as a primary alternative (alongside CLI) may subtly prioritize Windows users, as PowerShell is more commonly associated with Windows environments.
Recommendations
- Ensure that all command-line examples and tool references are provided for both Azure CLI and PowerShell, with equal prominence.
- Where possible, clarify that Azure CLI is cross-platform and suitable for Linux, macOS, and Windows.
- If including PowerShell, also mention that PowerShell Core is available cross-platform, or provide Bash/Shell alternatives for Linux users.
- Consider providing explicit Linux/Bash examples or links, especially in sections discussing management or automation.
- Review included markdown files (e.g., iot-hub-sdks-management.md) to ensure they do not contain Windows- or PowerShell-only instructions.
IoT
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/iot/iot-sdks.md
...softDocs/azure-docs/blob/main/articles/iot/iot-sdks.md
Low Priority
View Details →
Detected Bias Types
Windows First
Summary
The documentation references both Azure CLI and PowerShell as alternatives to the management SDKs, but lists Azure CLI first, followed by PowerShell and REST API. There are no explicit examples or instructions that are Windows-specific, nor is there an absence of Linux alternatives. However, the mention of PowerShell (a Windows-native tool, though now cross-platform) alongside Azure CLI (which is cross-platform and more commonly used on Linux) could suggest a slight Windows-first bias in tool listing order.
Recommendations
- Ensure that when listing management tools, cross-platform options like Azure CLI are always mentioned first, and clarify their cross-platform compatibility.
- Explicitly state that both Azure CLI and PowerShell are available on Windows, Linux, and macOS, to avoid the perception that PowerShell is Windows-only.
- Where possible, provide example commands for both Azure CLI and PowerShell, or clarify that instructions apply equally across platforms.
- Consider adding a short note or table summarizing tool availability and platform compatibility for new users.