Update Essentials Flashlight API Docs (#12144)

Co-authored-by: Gerald Versluis <gerald.versluis@microsoft.com>

src/Essentials/src/Flashlight/Flashlight.netstandard.tvos.watchos.macos.cs

@@ -3,7 +3,6 @@
 
 namespace Microsoft.Maui.Devices
 {
-	/// <include file="../../docs/Microsoft.Maui.Essentials/Flashlight.xml" path="Type[@FullName='Microsoft.Maui.Essentials.Flashlight']/Docs/*" />
 	class FlashlightImplementation : IFlashlight
 	{
 		public Task TurnOnAsync() =>

src/Essentials/src/Flashlight/Flashlight.shared.cs

@@ -3,26 +3,48 @@
 
 namespace Microsoft.Maui.Devices
 {
+	/// <summary>
+	/// The Flashlight API has the ability to turn on or off the device's camera flash to turn it into a flashlight.
+	/// </summary>
 	public interface IFlashlight
 	{
+		/// <summary>
+		/// Turns the camera flashlight on.
+		/// </summary>
+		/// <returns>A <see cref="Task"/> object with the current status of the asynchronous operation.</returns>
 		Task TurnOnAsync();
 
+		/// <summary>
+		/// Turns the camera flashlight off.
+		/// </summary>
+		/// <returns>A <see cref="Task"/> object with the current status of the asynchronous operation.</returns>
 		Task TurnOffAsync();
 	}
 
-	/// <include file="../../docs/Microsoft.Maui.Essentials/Flashlight.xml" path="Type[@FullName='Microsoft.Maui.Essentials.Flashlight']/Docs/*" />
+	/// <summary>
+	/// The Flashlight API has the ability to turn on or off the device's camera flash to turn it into a flashlight.
+	/// </summary>
 	public static partial class Flashlight
 	{
-		/// <include file="../../docs/Microsoft.Maui.Essentials/Flashlight.xml" path="//Member[@MemberName='TurnOnAsync']/Docs/*" />
+		/// <summary>
+		/// Turns the camera flashlight on.
+		/// </summary>
+		/// <returns>A <see cref="Task"/> object with the current status of the asynchronous operation.</returns>
 		public static Task TurnOnAsync() =>
 			Default.TurnOnAsync();
 
-		/// <include file="../../docs/Microsoft.Maui.Essentials/Flashlight.xml" path="//Member[@MemberName='TurnOffAsync']/Docs/*" />
+		/// <summary>
+		/// Turns the camera flashlight off.
+		/// </summary>
+		/// <returns>A <see cref="Task"/> object with the current status of the asynchronous operation.</returns>
 		public static Task TurnOffAsync() =>
 			Default.TurnOffAsync();
 
 		static IFlashlight? defaultImplementation;
 
+		/// <summary>
+		/// Provides the default implementation for static usage of this API.
+		/// </summary>
 		public static IFlashlight Default =>
 			defaultImplementation ??= new FlashlightImplementation();