Document Details
Developer Portal Faq
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
powershell_heavy
windows_tools
missing_linux_example
windows_first
Summary
The documentation shows a bias towards Windows environments by providing only PowerShell scripts for role assignment and management, referencing .bat scripts for cleanup, and omitting equivalent Bash or CLI examples for Linux/macOS users. Windows tools and patterns are mentioned exclusively, with no Linux alternatives or parity guidance.
Recommendations
- Provide Azure CLI or Bash script equivalents for all PowerShell examples, especially for role creation and assignment.
- Include instructions for running cleanup scripts on Linux/macOS (e.g., provide a .sh script or explain how to adapt the .bat script).
- When referencing scripts or commands, mention both Windows and Linux options, or clarify cross-platform compatibility.
- Order examples so that cross-platform or Linux-native tools (e.g., Azure CLI) are presented before or alongside Windows/PowerShell tools.
- Explicitly state platform requirements or limitations when only Windows tools are available, and link to alternative guidance for Linux users.
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-11 00:00 | #95 | cancelled |
 Clean
|
| 2026-01-10 00:00 | #92 | completed |
Clean
|
| 2026-01-09 00:00 | #87 | cancelled |
Biased
|
| 2026-01-08 00:00 | #84 | in_progress |
Clean
|
| 2026-01-06 22:28 | #78 | completed |
Clean
|
| 2025-12-29 18:00 | #48 | cancelled |
Biased
|
| 2025-12-22 00:00 | #24 | cancelled |
Clean
|
| 2025-12-15 00:00 | #7 | completed |
Clean
|
| 2025-12-14 05:05 | #6 | completed |
Clean
|
Flagged Code Snippets
#New Portals Admin Role
Import-Module Az
Connect-AzAccount
$contributorRole = Get-AzRoleDefinition "API Management Service Contributor"
$customRole = $contributorRole
$customRole.Id = $null
$customRole.Name = "APIM New Portal Admin"
$customRole.Description = "This role gives the user ability to log in to the new Developer portal as administrator"
$customRole.Actions = "Microsoft.ApiManagement/service/users/token/action"
$customRole.IsCustom = $true
$customRole.AssignableScopes.Clear()
$customRole.AssignableScopes.Add('/subscriptions/<subscription-id>')
New-AzRoleDefinition -Role $customRole
cd scripts.v3 .\cleanup.bat cd ..
New-AzRoleAssignment -SignInName "user1@contoso.com" -RoleDefinitionName "APIM New Portal Admin" -Scope "/subscriptions/<subscription-id>/resourceGroups/<resource-group>/providers/Microsoft.ApiManagement/service/<apim-service-name>/users/1"