Document Details
Mqtt Publish And Subscribe Portal
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
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation demonstrates a Windows bias in the certificate generation section, where instructions and examples are tailored for Windows users (e.g., opening a command prompt in %USERPROFILE% and using PowerShell commands), with no equivalent Linux or macOS instructions provided. The phrase 'Consider installing manually for Windows' implies a Windows-first approach, and there are no Bash or Linux terminal examples for certificate generation. The rest of the guide is platform-neutral, focusing on Azure Portal and MQTTX app, which are cross-platform.
Recommendations
- Add explicit instructions and command examples for Linux and macOS users, including how to open a terminal and navigate to the appropriate directory.
- Provide Bash shell equivalents for all certificate generation commands, including file path conventions and environment variables (e.g., $HOME instead of %USERPROFILE%).
- Clarify that the step CLI is cross-platform and link to installation guides for Linux and macOS.
- Avoid using Windows-specific terminology (such as 'Win+R') without providing cross-platform alternatives.
- Where screenshots or instructions are OS-specific, include alternatives for other platforms.
Create Pull Request
Scan History
| Date | Scan | Status | Result |
|---|---|---|---|
| 2026-01-12 00:00 | #99 | completed |
Biased
|
| 2026-01-11 06:20 | #98 | completed |
Biased
|
| 2026-01-10 00:00 | #92 | completed |
Biased
|
| 2026-01-06 22:28 | #78 | completed |
 Clean
|
| 2025-12-15 00:00 | #7 | completed |
Clean
|
| 2025-12-14 05:05 | #6 | completed |
Clean
|