doc/config-local-data: begin with typical examples

This doc page is relatively complex and it will only get longer
in future, but I expect that 90% of users will be OK with just
these simple examples.

diff --git a/doc/config-local-data.rst b/doc/config-local-data.rst
index 1e452021211e7b27b1344a4fccff580e27db276d..24293105889b71769553df538be944894a7ab395 100644 (file)
--- a/doc/config-local-data.rst
+++ b/doc/config-local-data.rst
@@ -8,6 +8,21 @@ Local Data and RPZ
 Local overrides for DNS data may be defined in the :option:`local-data <local-data:>` configuration tree.
 It provides various input formats described in following subsections.
 
+.. code-block:: yaml
+
+   # Some typical use cases:
+   local-data:
+     addresses:
+       a1.example.com: 2001:db8::1
+       a2.example.org: [ 192.0.2.2, 192.0.2.3, 2001:db8::4 ]
+     addresses-files:
+       - /etc/hosts
+     records: |
+       www.google.com.  CNAME  forcesafesearch.google.com.
+     rpz:
+       - file: /tmp/blocklist.rpz
+
+
 .. option:: local-data:
 
    .. option:: ttl: <time ms|s|m|h|d>