diff --git a/docs/reference/led/brightness.md b/docs/reference/led/brightness.md
index f6e2e4e1..c4f175c8 100644
--- a/docs/reference/led/brightness.md
+++ b/docs/reference/led/brightness.md
@@ -1,6 +1,6 @@
 # Brightness
 
-Find how bright the [LED screen](/device/screen) is.
+Find how bright the [LED screen](/device/screen) is _when it is turned on_.
 
 ```sig
 led.brightness();
@@ -8,11 +8,11 @@ led.brightness();
 
 ### Returns
 
-* a [Number](/reference/types/number) that means how bright the screen is, from `0` (darkest) to `255` (brightest). For example, the number `127` means the screen is halfway bright.
+* a [number](/reference/types/number) that means how bright the screen is when it is turned on, from `0` (darkest) to `255` (brightest). For example, the number `127` means the screen is halfway bright when it is turned on.
 
 ### Example: highest brightness
 
-This program makes the screen completely bright if it is not that way already:
+This program makes the screen completely bright when it is turned on (if it is not that way already):
 
 ```blocks
 if (led.brightness() < 255) {