diff --git a/doc/configuration.rst b/doc/configuration.rst
index ae49b61571c0cb44e197027510d4e1cd9d337691..684298804f0047a6bd0c2d0f7b1cddc3f46dab52 100644
--- a/doc/configuration.rst
+++ b/doc/configuration.rst
@@ -470,8 +470,40 @@ Limitations
   since the module is hooked in the query processing plan, it will be
   possible to do online signing in the future.
 
+``dnsproxy`` - Tiny DNS proxy 
+-----------------------------
+
+The module catches all unsatisfied queries and forwards them to the configured server for resolution,
+i.e. a tiny DNS proxy. This can be useful to several things:
+
+* A substitute public-facing server in front of the real one
+* Local zones (poor man's "views"), rest is forwarded to the public-facing server
+* etc.
+
+The configuration is straightforward and just accepts a single IP address (either IPv4 or IPv6).
+
+*Note: The module does not alter the query/response as the resolver would do, also the original
+transport protocol is kept.*
+
+Example
+^^^^^^^
+
+Example configuration::
+
+        $ vim knot.conf
+        knot.conf:
+        zones {
+                local.zone {}
+                query_module {
+                        dnsproxy "10.0.1.1";
+                }
+        }
+
+Now when the clients query for anything in the ``local.zone``, it will be answered locally.
+Rest of the requests will be forwarded to the specified server (``10.0.1.1`` in this case).
+
 ``rosedb`` - Static resource records
----------------------------------------
+------------------------------------
 
 The module provides a mean to override responses for certain queries before the record is searched in
 the available zones. The modules comes with a tool ``rosedb_tool`` to manipulate with the database
diff --git a/src/knot/modules/dnsproxy.h b/src/knot/modules/dnsproxy.h
index a54e1842f9752a5efdbc10896346920b9cc86740..48c0af0e6f6524bcb823c710cb65d1ed2d767c49 100644
--- a/src/knot/modules/dnsproxy.h
+++ b/src/knot/modules/dnsproxy.h
@@ -1,16 +1,16 @@
 /*!
- * \file synth_record.h
+ * \file dnsproxy.h
  *
  * \author Marek Vavrusa <marek.vavrusa@nic.cz>
  *
- * \brief Synthetic records module
+ * \brief DNS proxy module
  *
  * Accepted configurations:
- *  * "forward <prefix> <ttl> <address>/<netblock>"
- *  * "reverse <prefix> <zone> <ttl> <address>/<netblock>"
+ *  * "<address>"
  *
- * Module synthetises forward/reverse records based on a template when
- * the queried record can't be found in the zone contents.
+ * Module forwards all unsatisfied queries to the specified server in
+ * order to solve them, and then sends the response back, i.e. a tiny
+ * DNS proxy.
  *
  * \addtogroup query_processing
  * @{