Document Details

Notification Hubs Python Push Notification Tutorial
Home / Scan #48 / Notification Hubs Python Push Notification Tutorial
Sad Tux - Windows bias detected
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.
GitHub View on GitHub 📚 View on Microsoft Learn

Bias Analysis

Detected Bias Types
windows_first
windows_heavy_examples
Summary
The documentation page demonstrates a bias toward Windows platforms by consistently presenting Windows/Windows Phone notification examples first and in greater detail. The initial 'Get started tutorial' link and most code samples focus on Windows (WNS, MPNS) payloads, with screenshots and explanations centered around Windows notification headers and outcomes. Linux or cross-platform command-line usage, tools, or deployment scenarios are not discussed, and there is no mention of Linux-specific considerations or parity in the workflow.
Recommendations
  • Reorder examples to alternate or rotate the platform order, sometimes showing iOS or Android first.
  • Include explicit instructions or notes for running the Python code on Linux and macOS, such as environment setup, dependencies, and any OS-specific caveats.
  • Add screenshots or logs from non-Windows platforms to illustrate parity in debugging and outcomes.
  • Provide links to platform-agnostic or Linux/macOS-specific tutorials, not just Windows-centric ones.
  • Ensure that all references to 'Get started' or other tutorials are available for multiple platforms, not only Windows.
  • Mention any differences (or confirm the lack thereof) in using Notification Hubs from Linux-based servers or CI/CD pipelines.
GitHub Create Pull Request

Scan History

Date Scan Status Result
2026-01-14 00:00 #250 in_progress Clean Clean
2026-01-13 00:00 #246 completed Clean Clean
2026-01-11 00:00 #240 completed Clean Clean
2026-01-10 00:00 #237 completed Clean Clean
2026-01-09 00:34 #234 completed Clean Clean
2026-01-08 00:53 #231 completed Clean Clean
2026-01-06 18:15 #225 cancelled Clean Clean
2025-08-17 00:01 #83 cancelled Clean Clean
2025-07-13 21:37 #48 completed Biased Biased
2025-07-12 23:44 #41 cancelled Biased Biased

Flagged Code Snippets

var template = @"<toast><visual><binding template=""ToastText01""><text id=""1"">$(greeting_en)</text></binding></visual></toast>";

wns_payload = """<toast><visual><binding template=\"ToastText01\"><text id=\"1\">Hello world!</text></binding></visual></toast>"""
hub.send_windows_notification(wns_payload)

class Notification:
    def __init__(self, notification_format=None, payload=None, debug=0):
        valid_formats = ['template', 'apple', 'gcm',
                         'windows', 'windowsphone', "adm", "baidu"]
        if not any(x in notification_format for x in valid_formats):
            raise Exception(
                "Invalid Notification format. " +
                "Must be one of the following - 'template', 'apple', 'gcm', 'windows', 'windowsphone', 'adm', 'baidu'")

        self.format = notification_format
        self.payload = payload

        # array with keynames for headers
        # Note: Some headers are mandatory: Windows: X-WNS-Type, WindowsPhone: X-NotificationType
        # Note: For Apple you can set Expiry with header: ServiceBusNotification-ApnsExpiry
        # in W3C DTF, YYYY-MM-DDThh:mmTZD (for example, 1997-07-16T19:20+01:00).
        self.headers = None

wns_payload = """<toast><visual><binding template=\"ToastText01\"><text id=\"1\">Test</text></binding></visual></toast>"""
hub.send_windows_notification(wns_payload)

hub.send_windows_notification(wns_payload)