diff --git a/src/docs/markdown/caddyfile/directives/request_header.md b/src/docs/markdown/caddyfile/directives/request_header.md
index 6e7acfa..cce8cbf 100644
--- a/src/docs/markdown/caddyfile/directives/request_header.md
+++ b/src/docs/markdown/caddyfile/directives/request_header.md
@@ -6,6 +6,8 @@ title: request_header (Caddyfile directive)
 
 Manipulates HTTP header fields on the request. It can set, add, and delete header values, or perform replacements using regular expressions.
 
+If you intend to manipulate headers for proxying, use the [`header_up` subdirective](/docs/caddyfile/directives/reverse_proxy#header_up) of `reverse_proxy` instead, as those manipulations are proxy-aware.
+
 
 ## Syntax
 
diff --git a/src/docs/markdown/caddyfile/directives/reverse_proxy.md b/src/docs/markdown/caddyfile/directives/reverse_proxy.md
index 9cc873f..95e8601 100644
--- a/src/docs/markdown/caddyfile/directives/reverse_proxy.md
+++ b/src/docs/markdown/caddyfile/directives/reverse_proxy.md
@@ -85,7 +85,7 @@ reverse_proxy [<matcher>] [<upstreams...>] {
 	buffer_responses
 	max_buffer_size <size>
 
-	# request manipulation
+	# request/header manipulation
 	trusted_proxies [private_ranges] <ranges...>
 	header_up   [+|-]<field> [<value|regexp> [<replacement>]]
 	header_down [+|-]<field> [<value|regexp> [<replacement>]]