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
Bias Types:
⚠️
windows_first
⚠️
powershell_heavy
⚠️
missing_linux_example
Summary:
The documentation demonstrates a Windows bias by presenting Windows-specific details and examples before Linux equivalents, particularly in connection instructions (RDP for Windows is mentioned before SSH for Linux). There are no explicit Linux command-line examples (e.g., Bash or CLI), and the only code sample for SDK usage uses a Windows node agent SKU ('batch.node.windows amd64') without a Linux equivalent. Additionally, there are no PowerShell or Bash command examples for creating images or pools, and the REST API and CLI sections are OS-neutral but lack Linux-specific context.
Recommendations:
- Provide parallel Linux examples wherever Windows-specific instructions are given (e.g., show SSH before or alongside RDP).
- Include Linux node agent SKU examples in the SDK code samples (e.g., 'batch.node.ubuntu 20.04').
- Add Bash/CLI command examples for common tasks such as creating snapshots, images, and pools, not just REST API or .NET SDK.
- When referencing documentation, link to both Linux and Windows guides equally and in parallel.
- Ensure that all steps and considerations are clearly marked for both Windows and Linux users, especially where procedures differ.
Create pull request
Flagged Code Snippets
private static VirtualMachineConfiguration CreateVirtualMachineConfiguration(ImageReference imageReference)
{
return new VirtualMachineConfiguration(
imageReference: imageReference,
nodeAgentSkuId: "batch.node.windows amd64");
}
private static ImageReference CreateImageReference()
{
return new ImageReference(
virtualMachineImageId: "/subscriptions/{sub id}/resourceGroups/{resource group name}/providers/Microsoft.Compute/images/{image definition name}");
}
private static void CreateBatchPool(BatchClient batchClient, VirtualMachineConfiguration vmConfiguration)
{
try
{
CloudPool pool = batchClient.PoolOperations.CreatePool(
poolId: PoolId,
targetDedicatedComputeNodes: PoolNodeCount,
virtualMachineSize: PoolVMSize,
virtualMachineConfiguration: vmConfiguration);
pool.Commit();
}