diff --git a/doc/pages/command-parsing.asciidoc b/doc/pages/command-parsing.asciidoc
index aebe9eba..02b02b86 100644
--- a/doc/pages/command-parsing.asciidoc
+++ b/doc/pages/command-parsing.asciidoc
@@ -63,7 +63,7 @@ is treated as a literal `\\`.
 
 == Typed Expansions
 
-Quoted and Balanced strings startings with `%` might have an optional
+Quoted and Balanced strings starting with `%` might have an optional
 alphabetic *expansion type* between the `%` and their delimiter (which
 is always a punctuation character). This *expansion type* defines how the
 string content is going to be expanded.
@@ -71,7 +71,6 @@ string content is going to be expanded.
 - If the *expansion type* is empty, the string content is used verbatim.
 
 - If the *expansion type* is one of `sh`, `reg`, `opt`, `val` or `arg`,
-  The string is expanded according as described in
-  <<expansions#typed-expansions,`:doc expansion typed-expansions`>>
+  The string is expanded as described in <<expansions#,`:doc expansions`>>
 
 - For any other *expansion type* a parsing error is raised.
diff --git a/doc/pages/expansions.asciidoc b/doc/pages/expansions.asciidoc
index b1a22931..36e5d020 100644
--- a/doc/pages/expansions.asciidoc
+++ b/doc/pages/expansions.asciidoc
@@ -36,7 +36,9 @@ by whitespace into a single argument or prevent expansions from expanding:
 
 Expansions are processed when unquoted and anywhere inside double-quoted
 strings, but not inside unquoted words, inside single-quoted strings, or
-inside %-strings or other expansions. So:
+inside %-strings or other expansions (see
+<<command-parsing#typed-expansions, `:doc command-parsing typed-expansions`>>
+for full details). For example:
 
 * `echo %val{session}` echoes the current session ID