more clean up

Karl-Bridge-Microsoft · Karl-Bridge-Microsoft · commit ac98f672abb4 · 2024-03-07T16:39:36.000-08:00
diff --git a/windows.gaming.input.preview/devicecommand.md b/windows.gaming.input.preview/devicecommand.md
@@ -3,15 +3,15 @@
 -api-type: winrt enum
 ---
 
-<!-- Enumeration syntax
-public enum Windows.Gaming.Input.Preview.DeviceCommand : int
--->
+# Windows.Gaming.Input.Preview.DeviceCommand
 
-# DeviceCommand
+<!--
+public enum DeviceCommand
+-->
 
 ## -description
 
-Commands that can be executed on a GIP headset.
+Commands that can be executed on a GIP (Gaming Input Protocol) headset.
 
 ## -enum-fields
 
diff --git a/windows.gaming.input.preview/gamecontrollerbatterychargingstate.md b/windows.gaming.input.preview/gamecontrollerbatterychargingstate.md
@@ -3,11 +3,11 @@
 -api-type: winrt enum
 ---
 
-<!-- Enumeration syntax
-public enum Windows.Gaming.Input.Preview.GameControllerBatteryChargingState : int
--->
+# Windows.Gaming.Input.Preview.GameControllerBatteryChargingState
 
-# GameControllerBatteryChargingState
+<!--
+public enum GameControllerBatteryChargingState
+-->
 
 ## -description
 
diff --git a/windows.gaming.input.preview/gamecontrollerbatterykind.md b/windows.gaming.input.preview/gamecontrollerbatterykind.md
@@ -3,11 +3,11 @@
 -api-type: winrt enum
 ---
 
-<!-- Enumeration syntax
-public enum Windows.Gaming.Input.Preview.GameControllerBatteryKind : int
--->
+# Windows.Gaming.Input.Preview.GameControllerBatteryKind
 
-# GameControllerBatteryKind
+<!--
+public enum GameControllerBatteryKind
+-->
 
 ## -description
 
diff --git a/windows.gaming.input.preview/gamecontrollerbatterylevel.md b/windows.gaming.input.preview/gamecontrollerbatterylevel.md
@@ -3,11 +3,11 @@
 -api-type: winrt enum
 ---
 
-<!-- Enumeration syntax
-public enum Windows.Gaming.Input.Preview.GameControllerBatteryLevel : int
--->
+# Windows.Gaming.Input.Preview.GameControllerBatteryLevel
 
-# GameControllerBatteryLevel
+<!--
+public enum GameControllerBatteryLevel
+-->
 
 ## -description
 
diff --git a/windows.gaming.input.preview/gamecontrollerfirmwarecorruptreason.md b/windows.gaming.input.preview/gamecontrollerfirmwarecorruptreason.md
@@ -3,38 +3,44 @@
 -api-type: winrt enum
 ---
 
-<!-- Enumeration syntax
-public enum Windows.Gaming.Input.Preview.GameControllerFirmwareCorruptReason : int
--->
+# Windows.Gaming.Input.Preview.GameControllerFirmwareCorruptReason
 
-# GameControllerFirmwareCorruptReason
+<!--
+public enum GameControllerFirmwareCorruptReason
+-->
 
 ## -description
+
 The state of firmware corruption for a device.
 
 ## -enum-fields
+
 ### -field Unknown:0
+
 It is not known whether firmware is corrupt.
 
 ### -field NotCorrupt:1
+
 The firmware is not corrupt.
 
 ### -field TwoUpCorrupt:2
+
 The 2Up firmware is corrupt.
 
 ### -field AppCorrupt:3
+
 The app firmware is corrupt.
 
 ### -field RadioCorrupt:4
-The radio firmware is corrupt.
 
-### -field RadioCorrupt:4
 The radio firmware is corrupt.
 
 ### -field EepromCorrupt:5
+
 The EEPROM is corrupt.
 
 ### -field SafeToUpdate:6
+
 The firmware can be safely updated to recover from corruption.
 
 ## -remarks
diff --git a/windows.gaming.input.preview/gamecontrollerproviderinfo.md b/windows.gaming.input.preview/gamecontrollerproviderinfo.md
@@ -3,14 +3,16 @@
 -api-type: winrt class
 ---
 
-<!-- Class syntax.
-public class GameControllerProviderInfo 
--->
-
 # Windows.Gaming.Input.Preview.GameControllerProviderInfo
 
+<!--
+public static class GameControllerProviderInfo
+-->
+
 ## -description
 
+Provides info on a physical game controller connected to the system using GIP.SYS.
+
 > [!IMPORTANT]
 > Access to this class requires declaring the xboxAccessoryManagement capability
 
diff --git a/windows.gaming.input.preview/gamecontrollerproviderinfo_getparentproviderid_1741648735.md b/windows.gaming.input.preview/gamecontrollerproviderinfo_getparentproviderid_1741648735.md
@@ -11,15 +11,21 @@ public string GameControllerProviderInfo.GetParentProviderId(IGameControllerProv
 
 ## -description
 
+Retrieves the persistent ID of the parent device of a physical game controller connected to the system using GIP.SYS.
+
 > [!IMPORTANT]
 > Access to this API requires declaring the xboxAccessoryManagement capability
 
 ## -parameters
 
 ### -param provider
 
+A physical game controller device connected to the system.
+
 ## -returns
 
+The persistent ID of the parent device of a physical game controller.
+
 ## -remarks
 
 ## -see-also
diff --git a/windows.gaming.input.preview/gamecontrollerproviderinfo_getproviderid_376471084.md b/windows.gaming.input.preview/gamecontrollerproviderinfo_getproviderid_376471084.md
@@ -11,17 +11,25 @@ public string GameControllerProviderInfo.GetProviderId(IGameControllerProvider p
 
 ## -description
 
+Retrieves the persistent ID of a physical game controller connected to the system using GIP.SYS.
+
 > [!IMPORTANT]
 > Access to this class requires declaring the xboxAccessoryManagement capability
 
 ## -parameters
 
 ### -param provider
 
+A physical game controller device connected to the system.
+
 ## -returns
 
+The persistent ID of a physical game controller.
+
 ## -remarks
 
 ## -see-also
 
 ## -examples
+
+
diff --git a/windows.gaming.input.preview/headsetgeqgains.md b/windows.gaming.input.preview/headsetgeqgains.md
@@ -3,11 +3,11 @@
 -api-type: winrt struct
 ---
 
-<!-- Structure syntax.
-public struct HeadsetGeqGains 
--->
+# Windows.Gaming.Input.Preview.HeadsetGeqGains
 
-# HeadsetGeqGains
+<!--
+public struct HeadsetGeqGains
+-->
 
 ## -description
 
diff --git a/windows.gaming.input.preview/headsetlevel.md b/windows.gaming.input.preview/headsetlevel.md
@@ -3,11 +3,11 @@
 -api-type: winrt enum
 ---
 
-<!-- Enumeration syntax
-public enum Windows.Gaming.Input.Preview.HeadsetLevel : int
--->
+# Windows.Gaming.Input.Preview.HeadsetLevel
 
-# HeadsetLevel
+<!--
+public enum HeadsetLevel
+-->
 
 ## -description
 
diff --git a/windows.gaming.input.preview/headsetoperation.md b/windows.gaming.input.preview/headsetoperation.md
@@ -3,11 +3,11 @@
 -api-type: winrt enum
 ---
 
-<!-- Enumeration syntax
-public enum Windows.Gaming.Input.Preview.HeadsetOperation : int
--->
+# Windows.Gaming.Input.Preview.HeadsetOperation
 
-# HeadsetOperation
+<!--
+public enum HeadsetOperation
+-->
 
 ## -description
 
@@ -49,5 +49,6 @@ Controls whether the mix and volume dials are in-place or swapped. The buffer mu
 :::code language="csharp" source="code/csharp/HeadsetManagementSample.cs":::
 
 ## -see-also
+
 [GetHeadsetOperation](legacygipgamecontrollerprovider_GetHeadsetOperation.md)
 [SetHeadsetOperation](legacygipgamecontrollerprovider_SetHeadsetOperation.md)
diff --git a/windows.gaming.input.preview/legacygipgamecontrollerprovider.md b/windows.gaming.input.preview/legacygipgamecontrollerprovider.md
@@ -11,7 +11,7 @@ public sealed class LegacyGipGameControllerProvider
 
 ## -description
 
-Exposes a set of properties and functionality for administering gaming accessories, such as gamepads and headsets, that use the GIP protocol.
+Exposes a set of properties and functionality for administering gaming accessories, such as gamepads and headsets, that use the GIP (Gaming Input Protocol) protocol.
 
 > [!IMPORTANT]
 > Access to this class requires declaring the xboxAccessoryManagement capability
diff --git a/windows.gaming.input.preview/legacygipgamecontrollerprovider_appcompatversion.md b/windows.gaming.input.preview/legacygipgamecontrollerprovider_appcompatversion.md
@@ -3,15 +3,15 @@
 -api-type: winrt property
 ---
 
-<!-- Property syntax.
+# Windows.Gaming.Input.Preview.LegacyGipGameControllerProvider.AppCompatVersion
+
+<!--
 public uint AppCompatVersion { get; }
 -->
 
-# Windows.Gaming.Input.Preview.LegacyGipGameControllerProvider.AppCompatVersion
-
 ## -description
 
-Gets the app compat version reported by the GIP driver.
+Gets the app compat version reported by the GIP (Gaming Input Protocol) driver.
 
 ## -property-value
 
@@ -22,6 +22,7 @@ The current app compat version of the GIP driver.
 The app compat version may be used to determine whether the GIP driver is new enough to support a given feature.
 
 Features supported as of each version:
+
 |Version  |Features  |
 |---------|---------|
 |2     |Initial release         |
diff --git a/windows.gaming.input.preview/legacygipgamecontrollerprovider_batterychargingstate.md b/windows.gaming.input.preview/legacygipgamecontrollerprovider_batterychargingstate.md
@@ -3,12 +3,12 @@
 -api-type: winrt property
 ---
 
-<!-- Property syntax.
-public GameControllerBatteryChargingState BatteryChargingState { get; }
--->
-
 # Windows.Gaming.Input.Preview.LegacyGipGameControllerProvider.BatteryChargingState
 
+<!--
+public Windows.Gaming.Input.Preview.GameControllerBatteryChargingState BatteryChargingState { get; }
+-->
+
 ## -description
 
 Gets the battery charging state of the controller.
diff --git a/windows.gaming.input.preview/legacygipgamecontrollerprovider_batterykind.md b/windows.gaming.input.preview/legacygipgamecontrollerprovider_batterykind.md
@@ -3,12 +3,12 @@
 -api-type: winrt property
 ---
 
-<!-- Property syntax.
-public GameControllerBatteryKind BatteryKind { get; }
--->
-
 # Windows.Gaming.Input.Preview.LegacyGipGameControllerProvider.BatteryKind
 
+<!--
+public Windows.Gaming.Input.Preview.GameControllerBatteryKind BatteryKind { get; }
+-->
+
 ## -description
 
 Gets the controller's battery kind.
diff --git a/windows.gaming.input.preview/legacygipgamecontrollerprovider_batterylevel.md b/windows.gaming.input.preview/legacygipgamecontrollerprovider_batterylevel.md
@@ -3,12 +3,12 @@
 -api-type: winrt property
 ---
 
-<!-- Property syntax.
-public GameControllerBatteryLevel BatteryLevel { get; }
--->
-
 # Windows.Gaming.Input.Preview.LegacyGipGameControllerProvider.BatteryLevel
 
+<!--
+public Windows.Gaming.Input.Preview.GameControllerBatteryLevel BatteryLevel { get; }
+-->
+
 ## -description
 
 Gets the battery charge level of the controller.
diff --git a/windows.gaming.input.preview/legacygipgamecontrollerprovider_executecommand_1957933249.md b/windows.gaming.input.preview/legacygipgamecontrollerprovider_executecommand_1957933249.md
@@ -11,7 +11,7 @@ public void ExecuteCommand (Windows.Gaming.Input.Preview.DeviceCommand command);
 
 ## -description
 
-Executes a command on a legacy GIP headset.
+Executes a command on a legacy GIP (Gaming Input Protocol) headset.
 
 ## -parameters
 
diff --git a/windows.gaming.input.preview/legacygipgamecontrollerprovider_fromgamecontroller_421915006.md b/windows.gaming.input.preview/legacygipgamecontrollerprovider_fromgamecontroller_421915006.md
@@ -21,7 +21,7 @@ Controller to construct a LegacyGipGameControllerProvider for.
 
 ## -returns
 
-A LegacyGipGameControllerProvider if the controller is a GIP controller. Null if the controller is not a GIP controller.
+A LegacyGipGameControllerProvider if the controller is a GIP (Gaming Input Protocol) controller. Null if the controller is not a GIP controller.
 
 ## -remarks
 
diff --git a/windows.gaming.input.preview/legacygipgamecontrollerprovider_fromgamecontrollerprovider_1641665457.md b/windows.gaming.input.preview/legacygipgamecontrollerprovider_fromgamecontrollerprovider_1641665457.md
@@ -21,7 +21,7 @@ Controller provider to construct a LegacyGipGameControllerProvider for.
 
 ## -returns
 
-A LegacyGipGameControllerProvider if the controller is a GIP controller. Null if the controller is not a GIP controller.
+A LegacyGipGameControllerProvider if the controller is a GIP (Gaming Input Protocol) controller. Null if the controller is not a GIP controller.
 
 ## -remarks
 
diff --git a/windows.gaming.input.preview/legacygipgamecontrollerprovider_getextendeddeviceinfo_262080953.md b/windows.gaming.input.preview/legacygipgamecontrollerprovider_getextendeddeviceinfo_262080953.md
@@ -15,7 +15,7 @@ Retrieves identification information for the device.
 
 ## -returns
 
-An array of GIP device information provided by the device.
+An array of GIP (Gaming Input Protocol) device information provided by the device.
 
 ## -remarks
 
diff --git a/windows.gaming.input.preview/legacygipgamecontrollerprovider_isfirmwarecorrupted.md b/windows.gaming.input.preview/legacygipgamecontrollerprovider_isfirmwarecorrupted.md
diff --git a/windows.gaming.input.preview/legacygipgamecontrollerprovider_isinterfacesupported_893270864.md b/windows.gaming.input.preview/legacygipgamecontrollerprovider_isinterfacesupported_893270864.md
diff --git a/windows.gaming.input.preview/legacygipgamecontrollerprovider_issyntheticdevice.md b/windows.gaming.input.preview/legacygipgamecontrollerprovider_issyntheticdevice.md
diff --git a/windows.gaming.input.preview/legacygipgamecontrollerprovider_preferredtypes.md b/windows.gaming.input.preview/legacygipgamecontrollerprovider_preferredtypes.md
diff --git a/windows.gaming.input.preview/windows_gaming_input_preview.md b/windows.gaming.input.preview/windows_gaming_input_preview.md
diff --git a/windows.gaming.input/arcadestick.md b/windows.gaming.input/arcadestick.md
diff --git a/windows.gaming.input/flightstick.md b/windows.gaming.input/flightstick.md
diff --git a/windows.gaming.input/gamepad.md b/windows.gaming.input/gamepad.md
diff --git a/windows.gaming.input/racingwheel.md b/windows.gaming.input/racingwheel.md
