--- a/xml/en/docs/http/ngx_http_core_module.xml
+++ b/xml/en/docs/http/ngx_http_core_module.xml
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_core_module"
         link="/en/docs/http/ngx_http_core_module.html"
         lang="en"
-        rev="81">
+        rev="82">
 
 <section id="directives" name="Directives">
 
@@ -1047,10 +1047,24 @@ as the specified limit.
 </para>
 
 <para>
-Rate limit can also be set in the <var>$limit_rate</var> variable.
+The value can contain variables (1.17.0).
 It may be useful in cases where rate should be limited
 depending on a certain condition:
 <example>
+map $slow $rate {
+    1     4k;
+    2     8k;
+}
+
+limit_rate $rate;
+</example>
+</para>
+
+<para>
+Rate limit can also be set in the
+<link id="var_limit_rate"><var>$limit_rate</var></link> variable,
+however, since version 1.17.0, this method is not recommended:
+<example>
 server {
 
     if ($slow) {
@@ -1089,6 +1103,7 @@ directives.
 <para>
 Sets the initial amount after which the further transmission
 of a response to a client will be rate limited.
+The value can contain variables (1.17.0).
 </para>
 
 <para>