microsoft · anupriya13 · Sep 5, 2025 · Sep 4, 2025
@@ -1,4 +1,3 @@
-#
 # UpdateNativeApiDocs.ps1 is a PowerShell script designed to download the
 # API docs from the specified RNW CI build in ADO and integrate them into
 # our docs folder, properly tagged with New/Old architecture tags
@@ -48,7 +47,7 @@ Function Create-WinRtApiDocWithBadge([string]$SourceDocPath, [string]$DestDocPat
     $Content = $Content.Trim()
 
     # Write final file
-    $Content | Out-File -Encoding utf8NoBOM $DestDocPath
+    $Content | Out-File -Encoding utf8 $DestDocPath
 }
 
 Function Get-DocKind([string]$DocPath) {
@@ -130,7 +129,7 @@ Function Merge-WinRtApiDocs([string]$OldArchDocsPath, [string]$NewArchDocsPath,
                 $OldContent = $OldContent -replace "---(.*\r\n){1,}---\r\n\r\n", "`r`n`r`n# Old Architecture`r`n`r`n"
                 $OldContent = $OldContent -replace "\r\n#", "`r`n##"
 
-                ($NewContent + $OldContent) | Out-File -Encoding utf8NoBOM -NoNewline $MergedFilePath
+                ($NewContent + $OldContent) | Out-File -Encoding utf8 -NoNewline $MergedFilePath
                 Create-WinRtApiDocWithBadge -SourceDocPath $MergedFilePath -DestDocPath (Join-Path $OutputDocsPath $_) -BadgeMd $NewAndOldArchBadgeMd
             }
             $Kind = Get-DocKind -DocPath (Join-Path $OutputDocsPath $_)
@@ -140,12 +139,16 @@ Function Merge-WinRtApiDocs([string]$OldArchDocsPath, [string]$NewArchDocsPath,
 
     # Clean up links to enum type values (workaround for https://github.com/asklar/winmd2md/issues/10)
     (Get-ChildItem -Path $OutputDocsPath -File -Filter *-api-windows.md) | ForEach-Object {
-        $FilePath = $_
-        $FileContent = (Get-Content $FilePath -Raw)
-        $AllTypesByKind['enum'] | ForEach-Object {
-            $FileContent = $FileContent -replace "\($_#\w+\)", "($_)" 
+        $FilePath = $_.FullName
+        if (Test-Path $FilePath) {
+            $FileContent = Get-Content $FilePath -Raw
+            if ($AllTypesByKind.ContainsKey('enum')) {
+                $AllTypesByKind['enum'] | ForEach-Object {
+                    $FileContent = $FileContent -replace "\($_#\w+\)", "($_)"
+                }
+            }
+            $FileContent | Out-File -Encoding utf8 $FilePath
         }
-        $FileContent | Out-File -Encoding utf8NoBOM -NoNewLine $FilePath
     }
 
     # Recreate index (workaround for https://github.com/asklar/winmd2md/issues/10)
@@ -159,7 +162,9 @@ Function Merge-WinRtApiDocs([string]$OldArchDocsPath, [string]$NewArchDocsPath,
     $IndexContent += "`r`n"
 
     $AllTypesByKind.Keys | Where-Object { $_ -ne 'unknown' } | Sort-Object | ForEach-Object {
-        $IndexContent += "## $($_.Substring(0,1).ToUpper())$($_.Substring(1))$($_.EndsWith("s") ? "es" : "s")`r`n"
+        $KindLabel = "$($_.Substring(0,1).ToUpper())$($_.Substring(1))"
+        if ($_.EndsWith("s")) { $KindLabel += "es" } else { $KindLabel += "s" }
+        $IndexContent += "## $KindLabel`r`n"
         $AllTypesByKind[$_] | Sort-Object | ForEach-Object {
             $IndexContent += "- [$_]($_)`r`n"
         }
@@ -171,7 +176,7 @@ Function Merge-WinRtApiDocs([string]$OldArchDocsPath, [string]$NewArchDocsPath,
     $IndexPath = (Join-Path $OutputDocsPath "index-api-windows.md")
 
     Write-Host "Creating `"$IndexPath`""
-    $IndexContent | Out-File -Encoding utf8NoBOM $IndexPath
+    $IndexContent | Out-File -Encoding utf8 $IndexPath
 
     # Update sidebar
     $SidebarsFile = Join-Path $RepoRoot "website/sidebars.json"
@@ -181,9 +186,11 @@ Function Merge-WinRtApiDocs([string]$OldArchDocsPath, [string]$NewArchDocsPath,
     $NativeApiEntries += "native-api/Native-API-Reference"
 
     $AllTypesByKind.Keys | Where-Object { $_ -ne 'unknown' } | Sort-Object | ForEach-Object {
+        $KindLabel = "$($_.Substring(0,1).ToUpper())$($_.Substring(1))"
+        if ($_.EndsWith("s")) { $KindLabel += "es" } else { $KindLabel += "s" }
         $KindObject = @{}
         $KindObject['type'] = 'subcategory'
-        $KindObject['label'] = "$($_.Substring(0,1).ToUpper())$($_.Substring(1))$($_.EndsWith("s") ? "es" : "s")"
+        $KindObject['label'] = $KindLabel
         $KindObject['ids'] = @()
         $AllTypesByKind[$_] | Sort-Object | ForEach-Object {
             $KindObject['ids'] += "native-api/$_"
@@ -228,4 +235,4 @@ finally
     Set-Location -Path $StartingLocation
 }
 
-exit 0
+exit 0
@@ -1,4 +1,4 @@
----
+---
 id: AccessibilityAction
 title: AccessibilityAction
 ---
@@ -16,3 +16,4 @@ Type: `string`
 
 ## Referenced by
 - [`AccessibilityActionEventHandler`](AccessibilityActionEventHandler)
+
@@ -1,4 +1,4 @@
----
+---
 id: AccessibilityActionEventHandler
 title: AccessibilityActionEventHandler
 ---
@@ -12,3 +12,4 @@ void **`Invoke`**([`AccessibilityAction`](AccessibilityAction) action)
 
 ## Referenced by
 - [`DynamicAutomationProperties`](DynamicAutomationProperties)
+
@@ -1,4 +1,4 @@
----
+---
 id: AccessibilityInvokeEventHandler
 title: AccessibilityInvokeEventHandler
 ---
@@ -12,3 +12,4 @@ void **`Invoke`**()
 
 ## Referenced by
 - [`DynamicAutomationProperties`](DynamicAutomationProperties)
+
@@ -1,4 +1,4 @@
----
+---
 id: AccessibilityRoles
 title: AccessibilityRoles
 ---
@@ -44,3 +44,4 @@ Kind: `enum`
 
 ## Referenced by
 - [`DynamicAutomationProperties`](DynamicAutomationProperties)
+
@@ -1,4 +1,4 @@
----
+---
 id: AccessibilityStateCheckedValue
 title: AccessibilityStateCheckedValue
 ---
@@ -15,3 +15,4 @@ Kind: `enum`
 
 ## Referenced by
 - [`DynamicAutomationProperties`](DynamicAutomationProperties)
+
@@ -1,4 +1,4 @@
----
+---
 id: AccessibilityStates
 title: AccessibilityStates
 ---
@@ -15,3 +15,4 @@ Kind: `enum`
 |`Busy` | 0x3  |  |
 |`Expanded` | 0x4  |  |
 |`CountStates` | 0x5  |  |
+
@@ -1,4 +1,4 @@
----
+---
 id: AccessibilityValue
 title: AccessibilityValue
 ---
@@ -13,3 +13,4 @@ Kind: `enum`
 |`Max` | 0x1  |  |
 |`Now` | 0x2  |  |
 |`Text` | 0x3  |  |
+
@@ -1,4 +1,4 @@
----
+---
 id: ActivityIndicatorComponentView
 title: ActivityIndicatorComponentView
 ---
@@ -10,3 +10,4 @@ Kind: `class`
 Extends: [`ViewComponentView`](ViewComponentView)
 
 > **EXPERIMENTAL**
+
@@ -1,4 +1,4 @@
----
+---
 id: AnimationClass
 title: AnimationClass
 ---
@@ -17,3 +17,4 @@ Kind: `enum`
 
 ## Referenced by
 - [`IVisual`](IVisual)
+
@@ -1,4 +1,4 @@
----
+---
 id: AriaRole
 title: AriaRole
 ---
@@ -79,3 +79,4 @@ Kind: `enum`
 
 ## Referenced by
 - [`DynamicAutomationProperties`](DynamicAutomationProperties)
+
@@ -1,4 +1,4 @@
----
+---
 id: BackNavigationHandlerKind
 title: BackNavigationHandlerKind
 ---
@@ -14,3 +14,4 @@ Kind: `enum`
 
 ## Referenced by
 - [`QuirkSettings`](QuirkSettings)
+
@@ -1,4 +1,4 @@
----
+---
 id: BackfaceVisibility
 title: BackfaceVisibility
 ---
@@ -15,3 +15,4 @@ Kind: `enum`
 
 ## Referenced by
 - [`IVisual`](IVisual)
+
@@ -1,4 +1,4 @@
----
+---
 id: BorderEffect
 title: BorderEffect
 ---
@@ -21,3 +21,4 @@ Implements: [`IGraphicsEffect`](https://docs.microsoft.com/uwp/api/Windows.Graph
 
 ### Source
  [`IGraphicsEffectSource`](https://docs.microsoft.com/uwp/api/Windows.Graphics.Effects.IGraphicsEffectSource) `Source`
+
@@ -1,4 +1,4 @@
----
+---
 id: CallFunc
 title: CallFunc
 ---
@@ -14,3 +14,4 @@ void **`Invoke`**(Object runtime)
 
 ## Referenced by
 - [`CallInvoker`](CallInvoker)
+
@@ -1,4 +1,4 @@
----
+---
 id: CallInvoker
 title: CallInvoker
 ---
@@ -18,3 +18,4 @@ void **`InvokeSync`**([`CallFunc`](CallFunc) func)
 
 ## Referenced by
 - [`IReactContext`](IReactContext)
+
@@ -1,4 +1,4 @@
----
+---
 id: CanvasComposite
 title: CanvasComposite
 ---
@@ -25,3 +25,4 @@ Kind: `enum`
 
 ## Referenced by
 - [`CompositeStepEffect`](CompositeStepEffect)
+
@@ -1,4 +1,4 @@
----
+---
 id: CanvasEdgeBehavior
 title: CanvasEdgeBehavior
 ---
@@ -15,3 +15,4 @@ Kind: `enum`
 
 ## Referenced by
 - [`BorderEffect`](BorderEffect)
+
@@ -1,4 +1,4 @@
----
+---
 id: CharacterReceivedRoutedEventArgs
 title: CharacterReceivedRoutedEventArgs
 ---
@@ -24,3 +24,4 @@ Implements: [`RoutedEventArgs`](RoutedEventArgs)
 
 ## Referenced by
 - [`ComponentView`](ComponentView)
+
@@ -1,4 +1,4 @@
----
+---
 id: Color
 title: Color
 ---
@@ -47,3 +47,4 @@ bool **`Equals`**([`Color`](Color) color)
 
 ## Referenced by
 - [`ViewProps`](ViewProps)
+
@@ -1,4 +1,4 @@
----
+---
 id: ColorSourceEffect
 title: ColorSourceEffect
 ---
@@ -15,3 +15,4 @@ Implements: [`IGraphicsEffect`](https://docs.microsoft.com/uwp/api/Windows.Graph
 
 ### Name
  string `Name`
+
@@ -1,4 +1,4 @@
----
+---
 id: ComponentIslandComponentViewInitializer
 title: ComponentIslandComponentViewInitializer
 ---
@@ -14,3 +14,4 @@ void **`Invoke`**([`ContentIslandComponentView`](ContentIslandComponentView) vie
 
 ## Referenced by
 - [`IReactCompositionViewComponentBuilder`](IReactCompositionViewComponentBuilder)
+
@@ -1,4 +1,4 @@
----
+---
 id: ComponentView
 title: ComponentView
 ---
@@ -43,3 +43,4 @@ void **`ReleasePointerCapture`**([`Pointer`](Pointer) pointer)
 > **EXPERIMENTAL**
 
 Type: [`EventHandler`](https://docs.microsoft.com/uwp/api/Windows.Foundation.EventHandler-1)<Object>
+
@@ -1,4 +1,4 @@
----
+---
 id: ComponentViewFeatures
 title: ComponentViewFeatures
 ---
@@ -20,3 +20,4 @@ Kind: `enum`
 
 ## Referenced by
 - [`IReactCompositionViewComponentBuilder`](IReactCompositionViewComponentBuilder)
+
@@ -1,4 +1,4 @@
----
+---
 id: ComponentViewInitializer
 title: ComponentViewInitializer
 ---
@@ -16,3 +16,4 @@ void **`Invoke`**([`ComponentView`](ComponentView) view)
 
 ## Referenced by
 - [`IReactViewComponentBuilder`](IReactViewComponentBuilder)
+
@@ -1,4 +1,4 @@
----
+---
 id: ComponentViewUpdateMask
 title: ComponentViewUpdateMask
 ---
@@ -20,3 +20,4 @@ Kind: `enum`
 
 ## Referenced by
 - [`UpdateFinalizerDelegate`](UpdateFinalizerDelegate)
+
@@ -1,4 +1,4 @@
----
+---
 id: CompositeStepEffect
 title: CompositeStepEffect
 ---
@@ -21,3 +21,4 @@ Implements: [`IGraphicsEffect`](https://docs.microsoft.com/uwp/api/Windows.Graph
 
 ### Source
  [`IGraphicsEffectSource`](https://docs.microsoft.com/uwp/api/Windows.Graphics.Effects.IGraphicsEffectSource) `Source`
+
@@ -1,4 +1,4 @@
----
+---
 id: CompositionHwndHost
 title: CompositionHwndHost
 ---
@@ -45,3 +45,4 @@ Move focus to this [`CompositionHwndHost`](CompositionHwndHost)
 int64_t **`TranslateMessage`**(uint32_t msg, uint64_t wParam, int64_t lParam)
 
 > **EXPERIMENTAL**
+
@@ -1,4 +1,4 @@
----
+---
 id: CompositionStretch
 title: CompositionStretch
 ---
@@ -16,3 +16,4 @@ Kind: `enum`
 
 ## Referenced by
 - [`IDrawingSurfaceBrush`](IDrawingSurfaceBrush)
+