diff --git a/src/docs/markdown/caddyfile/directives/uri.md b/src/docs/markdown/caddyfile/directives/uri.md
index e414efc..ae9413b 100644
--- a/src/docs/markdown/caddyfile/directives/uri.md
+++ b/src/docs/markdown/caddyfile/directives/uri.md
@@ -11,10 +11,13 @@ This directive is distinct from [`rewrite`](rewrite) in that `uri` _partially_ c
 
 ## Syntax
 
+Multiple different operations are supported:
+
 ```caddy-d
-uri [<matcher>] strip_prefix|strip_suffix|replace|path_regexp \
-	<target> \
-	[<replacement> [<limit>]]
+uri [<matcher>] strip_prefix <target>
+uri [<matcher>] strip_suffix <target>
+uri [<matcher>] replace      <target> <replacement> [<limit>]
+uri [<matcher>] path_regexp  <target> <replacement>
 ```
 
 - The first (non-matcher) argument specifies the operation:
@@ -23,10 +26,18 @@ uri [<matcher>] strip_prefix|strip_suffix|replace|path_regexp \
 	- **replace** performs a substring replacement across the whole URI.
 	- **path_regexp** performs a regular expression replacement on the path portion of the URI.
 - **&lt;target&gt;** is the prefix, suffix, or search string/regular expression. If a prefix, the leading forward slash may be omitted, since paths always start with a forward slash.
-- **&lt;replacement&gt;** is the replacement string (only valid with `replace` and `path_regexp`).
+- **&lt;replacement&gt;** is the replacement string (only valid with `replace` and `path_regexp`). Supports using capture groups with `$name` or `${name}` syntax, or with a number for the index, such as `$1`. See the [Go documentation](https://golang.org/pkg/regexp/#Regexp.Expand) for details.
 - **&lt;limit&gt;** is an optional limit to the maximum number of replacements (only valid with `replace`).
 
 
+## Similar directives
+
+Some other directives can also manipulate the request URI.
+
+- [`rewrite`](rewrite) will change the entire path and query to a new value, instead of doing a partial change like `uri` does.
+- [`handle_path`](handle_path) does the same as [`handle`](handle), but it strips a prefix from the request before running its handlers. Can be used instead of `uri strip_prefix` to save a line of config in many situations.
+
+
 ## Examples
 
 Strip `/api` from the beginning of all request paths: