Document Details

Durable Functions Sub Orchestrations
Home / Scan #41 / Durable Functions Sub Orchestrations
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
powershell_heavy
windows_tools
windows_first
Summary
The documentation includes a prominent PowerShell-specific note and full PowerShell code examples alongside other languages, which may indicate a bias towards Windows-centric tooling and scripting environments. The PowerShell note appears before any mention of Linux or cross-platform considerations, and there is no explicit mention of Linux shell or Bash equivalents. The documentation does not provide Linux-specific guidance or highlight parity for Linux users, especially in the context of scripting and SDK support.
Recommendations
  • Add explicit notes about Linux support and any differences or limitations for Linux users, especially regarding the PowerShell SDK and its cross-platform compatibility.
  • Include Bash or shell script examples if relevant, or clarify that PowerShell examples are cross-platform (if true), or provide alternatives for Linux users.
  • Ensure that introductory notes and tooling guidance mention cross-platform scenarios and not just Windows/PowerShell environments.
  • Consider reordering notes and examples so that Windows/PowerShell-specific content does not always appear first or exclusively.
  • If PowerShell is not cross-platform in this context, provide clear guidance or links for Linux users to achieve similar functionality.
GitHub Create Pull Request

Scan History

Date Scan Status Result
2025-07-12 23:44 #41 cancelled Biased Biased
2025-07-12 00:58 #8 cancelled Clean Clean
2025-07-10 05:06 #7 processing Clean Clean
2025-07-09 23:22 #6 cancelled Clean Clean

Flagged Code Snippets

param($Context)

$deviceId = $Context.Input

# Step 1: Create an installation package in blob storage and return a SAS URL.
$sasUrl = Invoke-DurableActivity -FunctionName "CreateInstallationPackage" -Input $deviceId

# Step 2: Notify the device that the installation package is ready.
$deviceInfo = @{
    id = $deviceId
    url = $sasUrl
}
Invoke-DurableActivity -FunctionName "SendPackageUrlToDevice" -Input $deviceInfo

# Step 3: Wait for the device to acknowledge that it has downloaded the new package.
Start-DurableExternalEventListener -EventName "DownloadCompletedAck"

# Step 4: ...

param($Context)

$deviceIds = Invoke-DurableActivity -FunctionName "GetNewDeviceIds"

# Run multiple device provisioning flows in parallel
$provisioningTasks = @()
for ($i = 0; $i -lt $deviceIds.Count; $i++) {
    $deviceId = $deviceIds[$i]
    $childId = "$($Context.InstanceId):$i"
    $provisionTask = Invoke-DurableSubOrchestrator `
        -FunctionName "DeviceProvisioningOrchestration" `
        -Input $deviceId `
        -InstanceId $childId `
        -NoWait
    $provisioningTasks += $provisionTask
}

Wait-DurableTask -Task $provisioningTasks

# ...