From addd18af3ea828488e08aee3a0702883d92dec3a Mon Sep 17 00:00:00 2001
From: Maas Lalani <maas@lalani.dev>
Date: Mon, 7 Nov 2022 11:49:53 -0500
Subject: [PATCH] docs(readme): clarify Hide / Show commands

---
 README.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index 021a5d24..20f957f2 100644
--- a/README.md
+++ b/README.md
@@ -475,7 +475,8 @@ Sleep 1s    # 1s
 
 ### Hide
 
-The `Hide` command allows you to exclude commands from the output.
+The `Hide` command instructs VHS to stop capturing frames. It's useful to pause
+a recording to perform hidden commands.
 
 ```elixir
 Hide
@@ -506,9 +507,8 @@ Type 'rm example'
 
 ### Show
 
-The `Show` command allows you to specify that the following commands should be
-un-hidden in the output. Since commands are shown by default, this command is
-really only useful after using the `Hide` command.
+The `Show` command instructs VHS to begin capturing frames, again. It's useful
+after a `Hide` command to resume frame recording for the output.
 
 ```elixir
 Hide