diff --git a/docs/pages/enroll-resources/machine-id/troubleshooting.mdx b/docs/pages/enroll-resources/machine-id/troubleshooting.mdx
index d806e8d3902f..8945a7eddf3d 100644
--- a/docs/pages/enroll-resources/machine-id/troubleshooting.mdx
+++ b/docs/pages/enroll-resources/machine-id/troubleshooting.mdx
@@ -78,7 +78,9 @@ locked bot:
  1. Remove the lock on the bot's user
  1. Reset the bot's generation counter by creating a new bot instance
 
-To remove the lock, first find and remove the lock targeting the bot user:
+To remove the lock, first find and remove the lock targeting the bot user. For
+this example, we'll assume the bot is named `example`, which will have an
+associated Teleport user named `bot-example`:
 
 ```code
 $ tctl get locks
@@ -96,7 +98,8 @@ version: v2
 $ tctl rm lock/5cee949f-5203-4f3b-9805-dac35d798a16
 ```
 
-Next, use `tctl bots instances add` to generate a new join token for the bot:
+Next, use `tctl bots instances add` to generate a new join token for the
+preexisting bot `example`:
 ```code
 $ tctl bots instances add example
 ```