Edit for clarity

Author: Fishbowler

api-reference/commands/sleep.md

@@ -6,4 +6,9 @@
 - sleep: 100     # Sleeps for 100ms (default unit is ms)
 - sleep: 1000ms  # Sleeps for 1000ms
 - sleep: 1s      # Sleeps for 1 second
+- sleep:
+    time: 2000
+    label: Pause for two seconds
 ```
+
+Note: This command shouldn't be necessary in most situations. Use [assertVisible](./assertvisible.md) or [extendedWaitUntil](./extendedwaituntil.md) to wait for something to appear. This command should be used in situations where an external system is performing a task that you cannot see the effect of (e.g. server-side transaction processing), or a splash animation that cannot be represented in the Maestro hierarchy that needs to be awaited.

api-reference/commands/waitforanimationtoend.md

@@ -13,4 +13,4 @@ Can have an optional timeout (in milliseconds) after which, if the animation is
     timeout: 5000
 ```
 
-If you want to add a fixed delay, see [sleep](./sleep.md).
+If you're looking to add a fixed delay, use [sleep](./sleep.md) instead.