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 page demonstrates a Windows bias in the certificate generation section, where instructions are tailored for Windows users (e.g., opening a command prompt in %USERPROFILE% and using PowerShell syntax). There are no equivalent Linux or macOS instructions or examples provided for certificate creation, and the initial guidance is Windows-centric. The rest of the guide is platform-neutral, especially when using MQTTX, but the critical setup steps lack Linux parity.
Recommendations
- Add explicit instructions and example commands for Linux and macOS users, including how to open a terminal and navigate to the home directory.
- Provide bash/zsh shell command equivalents for certificate generation using step CLI.
- Mention Linux/macOS file paths (e.g., $HOME instead of %USERPROFILE%) and clarify any platform-specific differences in file handling.
- Ensure that screenshots and instructions do not assume a Windows environment unless necessary, and offer alternatives for other platforms.
- Consider a 'Platform differences' callout box in the prerequisites or certificate generation section.
Create Pull Request
Scan History
| Date | Scan | Status | Result |
|---|---|---|---|
| 2026-01-14 00:00 | #250 | in_progress |
Biased
|
| 2026-01-13 00:00 | #246 | completed |
Biased
|
| 2026-01-11 00:00 | #240 | completed |
Biased
|
| 2026-01-10 00:00 | #237 | completed |
Biased
|
| 2026-01-09 00:34 | #234 | completed |
Biased
|
| 2026-01-08 00:53 | #231 | completed |
Biased
|
| 2026-01-06 18:15 | #225 | cancelled |
 Clean
|
| 2025-08-17 00:01 | #83 | cancelled |
Clean
|
| 2025-07-13 21:37 | #48 | completed |
Clean
|
| 2025-07-09 13:09 | #3 | cancelled |
Clean
|
| 2025-07-08 04:23 | #2 | cancelled |
Biased
|