doc: dnstap module polish for new docs structure

diff --git a/modules/dnstap/README.rst b/modules/dnstap/README.rst
index 442b4cfcd2bc204aae4e2d7faf8d9338737b1bad..19bdae8e1319775fe179e48222d8fd5b60ac9a0b 100644 (file)
--- a/modules/dnstap/README.rst
+++ b/modules/dnstap/README.rst
@@ -3,16 +3,16 @@
 Dnstap
 ------
 
-Dnstap module currently supports logging dns responses to a unix socket
-in dnstap format using fstrm framing library.  The unix socket and the
-socket reader should be present before starting kresd.
+The ``dnstap`` module supports logging DNS responses to a unix socket
+in dnstap_ format using fstrm framing library.
+This logging is useful if you need effectivelly log all DNS traffic.
+
+The unix socket and the socket reader must be present before starting resolver instances.
 
-Configuration
-^^^^^^^^^^^^^
 Tunables:
 
 * ``socket_path``: the the unix socket file where dnstap messages will be sent
-* ``log_responses``: if true responses in wire format will be logged
+* ``log_responses``: if ``true`` responses in wire format will be logged
 
 .. code-block:: lua