diff --git a/src/Essentials/docs/en/Xamarin.Essentials/Flashlight.xml b/src/Essentials/docs/en/Xamarin.Essentials/Flashlight.xml
deleted file mode 100644
index fd623784ff3a..000000000000
--- a/src/Essentials/docs/en/Xamarin.Essentials/Flashlight.xml
+++ /dev/null
@@ -1,57 +0,0 @@
-
-
-
-
-
- Xamarin.Essentials
- 1.0.0.0
-
-
- System.Object
-
-
-
- Turn the Flashlight / Torch / Lamp On and Off.
-
-
-
-
-
-
-
- Method
-
- 1.0.0.0
- Xamarin.Essentials
-
-
- System.Threading.Tasks.Task
-
-
-
- Turns the Flashlight Off.
-
-
-
-
-
-
-
-
- Method
-
- 1.0.0.0
- Xamarin.Essentials
-
-
- System.Threading.Tasks.Task
-
-
-
- Turns the Flashlight On.
-
-
-
-
-
-
diff --git a/src/Essentials/src/Flashlight/Flashlight.netstandard.tvos.watchos.macos.cs b/src/Essentials/src/Flashlight/Flashlight.netstandard.tvos.watchos.macos.cs
index c971868377bd..09d374556cb1 100644
--- a/src/Essentials/src/Flashlight/Flashlight.netstandard.tvos.watchos.macos.cs
+++ b/src/Essentials/src/Flashlight/Flashlight.netstandard.tvos.watchos.macos.cs
@@ -3,7 +3,6 @@
namespace Microsoft.Maui.Devices
{
- ///
class FlashlightImplementation : IFlashlight
{
public Task TurnOnAsync() =>
diff --git a/src/Essentials/src/Flashlight/Flashlight.shared.cs b/src/Essentials/src/Flashlight/Flashlight.shared.cs
index 1b584b0e92d0..9d4a06bb8957 100644
--- a/src/Essentials/src/Flashlight/Flashlight.shared.cs
+++ b/src/Essentials/src/Flashlight/Flashlight.shared.cs
@@ -3,26 +3,48 @@
namespace Microsoft.Maui.Devices
{
+ ///
+ /// The Flashlight API has the ability to turn on or off the device's camera flash to turn it into a flashlight.
+ ///
public interface IFlashlight
{
+ ///
+ /// Turns the camera flashlight on.
+ ///
+ /// A object with the current status of the asynchronous operation.
Task TurnOnAsync();
+ ///
+ /// Turns the camera flashlight off.
+ ///
+ /// A object with the current status of the asynchronous operation.
Task TurnOffAsync();
}
- ///
+ ///
+ /// The Flashlight API has the ability to turn on or off the device's camera flash to turn it into a flashlight.
+ ///
public static partial class Flashlight
{
- ///
+ ///
+ /// Turns the camera flashlight on.
+ ///
+ /// A object with the current status of the asynchronous operation.
public static Task TurnOnAsync() =>
Default.TurnOnAsync();
- ///
+ ///
+ /// Turns the camera flashlight off.
+ ///
+ /// A object with the current status of the asynchronous operation.
public static Task TurnOffAsync() =>
Default.TurnOffAsync();
static IFlashlight? defaultImplementation;
+ ///
+ /// Provides the default implementation for static usage of this API.
+ ///
public static IFlashlight Default =>
defaultImplementation ??= new FlashlightImplementation();