diff --git a/pages/common/asciinema.md b/pages/common/asciinema.md
index ce99aee19e..48b84620c9 100644
--- a/pages/common/asciinema.md
+++ b/pages/common/asciinema.md
@@ -1,25 +1,26 @@
 # asciinema
 
-> Record and replay terminal sessions, and optionally share them on asciinema.org.
-> More information: <https://asciinema.org/docs/usage>.
+> Record and replay terminal sessions, and optionally share them on <https://asciinema.org>.
+> See also: `terminalizer`.
+> More information: <https://docs.asciinema.org/manual/cli/usage>.
 
 - Associate the local install of `asciinema` with an asciinema.org account:
 
 `asciinema auth`
 
-- Make a new recording (once finished, user will be prompted to upload it or save it locally):
+- Make a new recording (finish it with `Ctrl+D` or type `exit`, and then choose to upload it or save it locally):
 
 `asciinema rec`
 
 - Make a new recording and save it to a local file:
 
-`asciinema rec {{path/to/file.cast}}`
+`asciinema rec {{path/to/recording.cast}}`
 
 - Replay a terminal recording from a local file:
 
-`asciinema play {{path/to/file.cast}}`
+`asciinema play {{path/to/recording.cast}}`
 
-- Replay a terminal recording hosted on asciinema.org:
+- Replay a terminal recording hosted on <https://asciinema.org>:
 
 `asciinema play https://asciinema.org/a/{{cast_id}}`
 
@@ -29,8 +30,8 @@
 
 - Print the full output of a locally saved recording:
 
-`asciinema cat {{path/to/file.cast}}`
+`asciinema cat {{path/to/recording.cast}}`
 
 - Upload a locally saved terminal session to asciinema.org:
 
-`asciinema upload {{path/to/file.cast}}`
+`asciinema upload {{path/to/recording.cast}}`
diff --git a/pages/common/terminalizer.md b/pages/common/terminalizer.md
index 72cb19aac9..4d4fb4b65d 100644
--- a/pages/common/terminalizer.md
+++ b/pages/common/terminalizer.md
@@ -1,6 +1,7 @@
 # terminalizer
 
-> Utility program which records the terminal and generate animated GIFs or share a video.
+> Record the terminal, generate animated GIFs and a web player, and optionally upload to <https://terminalizer.com>.
+> See also: `asciinema`.
 > More information: <https://terminalizer.com>.
 
 - Create the global configuration directory:
@@ -9,16 +10,16 @@
 
 - Record the terminal and create a recording file:
 
-`terminalizer record {{path/to/file}}`
+`terminalizer record {{path/to/recording.gif}}`
 
 - Play a recorded file on the terminal:
 
-`terminalizer play {{path/to/file}}`
+`terminalizer play {{path/to/recording.gif}}`
 
 - Render a recording file as an animated GIF image:
 
-`terminalizer render {{path/to/file}}`
+`terminalizer render {{path/to/recording.gif}}`
 
-- Upload a video to terminalizer.com:
+- Upload a video to <https://terminalizer.com>:
 
-`terminalizer share {{path/to/file}}`
+`terminalizer share {{path/to/recording.gif}}`