Second pass. Clarify API's functionality.
This commit is contained in:
		@@ -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) {
 | 
			
		||||
 
 | 
			
		||||
		Reference in New Issue
	
	Block a user