update doc to not use the root zone for everything (#3288)

Update all documentation in the tree to use example.org as an example
configuration (in so far possible). As to get out of the just use "."
and fallthrough and things would be fine.

Signed-off-by: Miek Gieben <miek@miek.nl>

14 files changed, 62 insertions, 45 deletions

diff --git a/README.md b/README.md
index d2508c830..72f2ef2c9 100644
--- a/README.md
+++ b/README.md
@@ -82,8 +82,11 @@ When starting CoreDNS without any configuration, it loads the
 
 ~~~ txt
 .:53
-2016/09/18 09:20:50 [INFO] CoreDNS-001
-CoreDNS-001
+   ______                ____  _   _______
+  / ____/___  ________  / __ \/ | / / ___/	~ CoreDNS-1.6.3
+ / /   / __ \/ ___/ _ \/ / / /  |/ /\__ \ 	~ linux/amd64, go1.13,
+/ /___/ /_/ / /  /  __/ /_/ / /|  /___/ /
+\____/\____/_/   \___/_____/_/ |_//____/
 ~~~
 
 Any query sent to port 53 should return some information; your sending address, port and protocol
@@ -128,17 +131,20 @@ Serve `example.org` on port 1053, but forward everything that does *not* match `
 recursive nameserver *and* rewrite ANY queries to HINFO.
 
 ~~~ txt
-.:1053 {
-    rewrite ANY HINFO
-    forward . 8.8.8.8:53
-
-    file /var/lib/coredns/example.org.signed example.org {
+example.org:1053 {
+    file /var/lib/coredns/example.org.signed {
         transfer to *
         transfer to 2001:500:8f::53
     }
     errors
     log
 }
+. {
+    any
+    forward . 8.8.8.8:53
+    errors
+    log
+}
 ~~~
 
 IP addresses are also allowed. They are automatically converted to reverse zones:
diff --git a/plugin/auto/README.md b/plugin/auto/README.md
index e313c966d..26c232c4d 100644
--- a/plugin/auto/README.md
+++ b/plugin/auto/README.md
@@ -56,8 +56,8 @@ Load `org` domains from `/etc/coredns/zones/org` and allow transfers to the inte
 notifies to 10.240.1.1
 
 ~~~ corefile
-. {
-    auto org {
+org {
+    auto {
         directory /etc/coredns/zones/org
         transfer to *
         transfer to 10.240.1.1
diff --git a/plugin/cache/README.md b/plugin/cache/README.md
index 8b2bdf075..9f97ba437 100644
--- a/plugin/cache/README.md
+++ b/plugin/cache/README.md
@@ -93,13 +93,13 @@ Proxy to Google Public DNS and only cache responses for example.org (or below).
 }
 ~~~
 
-Enable caching for all zones, keep a positive cache size of 5000 and a negative cache size of 2500:
+Enable caching for `example.org`, keep a positive cache size of 5000 and a negative cache size of 2500:
 
 ~~~ corefile
- . {
-     cache {
-         success 5000
-         denial 2500
+example.org {
+    cache {
+        success 5000
+        denial 2500
     }
- }
- ~~~
+}
+~~~
diff --git a/plugin/cancel/README.md b/plugin/cancel/README.md
index 9f7c470d9..8561b1f6b 100644
--- a/plugin/cancel/README.md
+++ b/plugin/cancel/README.md
@@ -25,7 +25,7 @@ cancel [TIMEOUT]
 ## Examples
 
 ~~~ corefile
-. {
+example.org {
     cancel
     whoami
 }
@@ -34,7 +34,7 @@ cancel [TIMEOUT]
 Or with a custom timeout:
 
 ~~~ corefile
-. {
+example.org {
     cancel 1s
     whoami
 }
diff --git a/plugin/clouddns/README.md b/plugin/clouddns/README.md
index dcb9aafa8..18d95cb31 100644
--- a/plugin/clouddns/README.md
+++ b/plugin/clouddns/README.md
@@ -49,7 +49,7 @@ clouddns [ZONE:PROJECT_ID:HOSTED_ZONE_NAME...] {
 Enable clouddns with implicit GCP credentials and resolve CNAMEs via 10.0.0.1:
 
 ~~~ txt
-. {
+example.org {
     clouddns example.org.:gcp-example-project:example-zone
     forward . 10.0.0.1
 }
@@ -58,7 +58,7 @@ Enable clouddns with implicit GCP credentials and resolve CNAMEs via 10.0.0.1:
 Enable clouddns with fallthrough:
 
 ~~~ txt
-. {
+example.org {
     clouddns example.org.:gcp-example-project:example-zone clouddns example.com.:gcp-example-project:example-zone-2 {
         fallthrough example.gov.
     }
diff --git a/plugin/debug/README.md b/plugin/debug/README.md
index fd769843d..a6234866d 100644
--- a/plugin/debug/README.md
+++ b/plugin/debug/README.md
@@ -45,4 +45,4 @@ Disable the ability to recover from crashes and show debug logging:
 
 ## Also See
 
-https://www.wireshark.org/docs/man-pages/text2pcap.html.
+<https://www.wireshark.org/docs/man-pages/text2pcap.html>.
diff --git a/plugin/erratic/README.md b/plugin/erratic/README.md
index e3bd79ae8..dcd74097c 100644
--- a/plugin/erratic/README.md
+++ b/plugin/erratic/README.md
@@ -40,7 +40,7 @@ This plugin reports readiness to the ready plugin.
 ## Examples
 
 ~~~ corefile
-. {
+example.org {
     erratic {
         drop 3
     }
@@ -50,7 +50,7 @@ This plugin reports readiness to the ready plugin.
 Or even shorter if the defaults suits you. Note this only drops queries, it does not delay them.
 
 ~~~ corefile
-. {
+example.org {
     erratic
 }
 ~~~
@@ -58,7 +58,7 @@ Or even shorter if the defaults suits you. Note this only drops queries, it does
 Delay 1 in 3 queries for 50ms
 
 ~~~ corefile
-. {
+example.org {
     erratic {
         delay 3 50ms
     }
@@ -68,7 +68,7 @@ Delay 1 in 3 queries for 50ms
 Delay 1 in 3 and truncate 1 in 5.
 
 ~~~ corefile
-. {
+example.org {
     erratic {
         delay 3 5ms
         truncate 5
@@ -79,7 +79,7 @@ Delay 1 in 3 and truncate 1 in 5.
 Drop every second query.
 
 ~~~ corefile
-. {
+example.org {
     erratic {
         drop 2
         truncate 2
@@ -89,5 +89,4 @@ Drop every second query.
 
 ## Also See
 
-[RFC 3849](https://tools.ietf.org/html/rfc3849) and
-[RFC 5737](https://tools.ietf.org/html/rfc5737).
+[RFC 3849](https://tools.ietf.org/html/rfc3849) and [RFC 5737](https://tools.ietf.org/html/rfc5737).
diff --git a/plugin/errors/README.md b/plugin/errors/README.md
index 5feef2694..61ed582cb 100644
--- a/plugin/errors/README.md
+++ b/plugin/errors/README.md
@@ -38,10 +38,10 @@ For better performance, it's recommended to use the `^` or `$` metacharacters in
 
 ## Examples
 
-Use the *whoami* to respond to queries and Log errors to standard output.
+Use the *whoami* to respond to queries in the example.org domain and Log errors to standard output.
 
 ~~~ corefile
-. {
+example.org {
     whoami
     errors
 }
diff --git a/plugin/etcd/README.md b/plugin/etcd/README.md
index 3b909fcac..9b7f75f29 100644
--- a/plugin/etcd/README.md
+++ b/plugin/etcd/README.md
@@ -77,15 +77,19 @@ This causes two lookups from CoreDNS to etcdv3 in certain cases.
 This is the default SkyDNS setup, with everything specified in full:
 
 ~~~ corefile
-. {
-    etcd skydns.local {
+skydns.local {
+    etcd {
         path /skydns
         endpoint http://localhost:2379
     }
     prometheus
-    cache 160 skydns.local
+    cache
     loadbalance
+}
+
+. {
     forward . 8.8.8.8:53 8.8.4.4:53
+    cache
 }
 ~~~
 
@@ -93,12 +97,16 @@ Or a setup where we use `/etc/resolv.conf` as the basis for the proxy and the up
 when resolving external pointing CNAMEs.
 
 ~~~ corefile
-. {
-    etcd skydns.local {
+skydns.local {
+    etcd {
         path /skydns
     }
-    cache 160 skydns.local
+    cache
+}
+
+. {
     forward . /etc/resolv.conf
+    cache
 }
 ~~~
 
diff --git a/plugin/hosts/README.md b/plugin/hosts/README.md
index b18438cc6..044ce3671 100644
--- a/plugin/hosts/README.md
+++ b/plugin/hosts/README.md
@@ -104,11 +104,12 @@ next plugin if query doesn't match.
 Load hosts file inlined in Corefile.
 
 ~~~
-. {
-    hosts example.hosts example.org {
+example.hosts example.org {
+    hosts {
         10.0.0.1 example.org
         fallthrough
     }
+    whoami
 }
 ~~~
 
diff --git a/plugin/log/README.md b/plugin/log/README.md
index bbd853bd3..8b397bffa 100644
--- a/plugin/log/README.md
+++ b/plugin/log/README.md
@@ -92,7 +92,7 @@ The default Common Log Format is:
 Each of these logs will be outputted with `log.Infof`, so a typical example looks like this:
 
 ~~~ txt
-2018-10-30T19:10:07.547Z [INFO] [::1]:50759 - 29008 "A IN example.org. udp 41 false 4096" NOERROR qr,rd,ra,ad 68 0.037990251s
+[INFO] [::1]:50759 - 29008 "A IN example.org. udp 41 false 4096" NOERROR qr,rd,ra,ad 68 0.037990251s
 ~~~~
 
 ## Examples
diff --git a/plugin/nsid/README.md b/plugin/nsid/README.md
index 0ff5cd764..c50acbf59 100644
--- a/plugin/nsid/README.md
+++ b/plugin/nsid/README.md
@@ -28,7 +28,7 @@ If **DATA** is not given, the host's name is used.
 Enable nsid:
 
 ~~~ corefile
-. {
+example.org {
     whoami
     nsid Use The Force
 }
diff --git a/plugin/route53/README.md b/plugin/route53/README.md
index e704ced60..c0e7dd2df 100644
--- a/plugin/route53/README.md
+++ b/plugin/route53/README.md
@@ -62,8 +62,11 @@ route53 [ZONE:HOSTED_ZONE_ID...] {
 Enable route53 with implicit AWS credentials and resolve CNAMEs via 10.0.0.1:
 
 ~~~ txt
-. {
+example.org {
 	route53 example.org.:Z1Z2Z3Z4DZ5Z6Z7
+}
+
+. {
     forward . 10.0.0.1
 }
 ~~~
@@ -71,7 +74,7 @@ Enable route53 with implicit AWS credentials and resolve CNAMEs via 10.0.0.1:
 Enable route53 with explicit AWS credentials:
 
 ~~~ txt
-. {
+example.org {
     route53 example.org.:Z1Z2Z3Z4DZ5Z6Z7 {
       aws_access_key AWS_ACCESS_KEY_ID AWS_SECRET_ACCESS_KEY
     }
@@ -91,14 +94,14 @@ Enable route53 with fallthrough:
 Enable route53 with multiple hosted zones with the same domain:
 
 ~~~ txt
-. {
+example.org {
     route53 example.org.:Z1Z2Z3Z4DZ5Z6Z7 example.org.:Z93A52145678156
 }
 ~~~
 
 Enable route53 and refresh records every 3 minutes
 ~~~ txt
-. {
+example.org {
     route53 example.org.:Z1Z2Z3Z4DZ5Z6Z7 {
       refresh 3m
     }
diff --git a/plugin/whoami/README.md b/plugin/whoami/README.md
index 7417132cc..55d0388d7 100644
--- a/plugin/whoami/README.md
+++ b/plugin/whoami/README.md
@@ -34,7 +34,7 @@ whoami
 Start a server on the default port and load the *whoami* plugin.
 
 ~~~ corefile
-. {
+example.org {
     whoami
 }
 ~~~