From f9e5d6275df7fe4f185f3fd04913c5d2c39c64e8 Mon Sep 17 00:00:00 2001
From: "ma.azimi@laposte.net" <ma.azimi@laposte.net>
Date: Mon, 15 Feb 2016 18:54:04 +0100
Subject: [PATCH] Update dns_config.md

---
 dns_config.md | 42 +++++++++++++++++++++++++++---------------
 1 file changed, 27 insertions(+), 15 deletions(-)

diff --git a/dns_config.md b/dns_config.md
index de1292c8..7379c256 100644
--- a/dns_config.md
+++ b/dns_config.md
@@ -1,31 +1,43 @@
-#DNS Configuration
+## DNS zone configuration
 
-Sample DNS config for domain.tld
+Sample DNS zone configuration for `domain.tld` domain nane:
 
+#### Redirection from the domain name to the IP address
 ```bash
-#### IPv4 & IPv6
-@ 900 IN A 111.222.333.444 (Minimal)
-* 900 IN A 111.222.333.444 (wildcard)
-@ 900 IN AAAA 2001:AABB:CCDD:EEFF:1122:3344:5566:7788
+@ 900 IN A 111.222.333.444 # (Minimal) IPv4
+@ 900 IN AAAA 2001:AABB:CCDD:EEFF:1122:3344:5566:7788 # IPv6
+
+* 900 IN A 111.222.333.444 # Wildcard
 * 900 IN AAAA 2001:AABB:CCDD:EEFF:1122:3344:5566:7788
+```
 
-#### Handle www subdomain
-www 1800 IN CNAME @
+#### Subdomains
+```bash
+www 1800 IN CNAME @ # accesible at www.domain.tld
+```
 
-#### XMPP/Jabber subdomains
-_xmpp-client._tcp 14400 IN SRV 0 5 5222 domain.tld. (Minimal)
-_xmpp-server._tcp 14400 IN SRV 0 5 5269 domain.tld. (Minimal)
-muc 1800 IN CNAME @
+#### XMPP
+```bash
+_xmpp-client._tcp 14400 IN SRV 0 5 5222 domain.tld. # (Minimal) clients connection
+_xmpp-server._tcp 14400 IN SRV 0 5 5269 domain.tld. # (Minimal) servers connection
+muc 1800 IN CNAME @ # multi-user chat rooms at muc.domain.tld
 pubsub 1800 IN CNAME @
 vjud 1800 IN CNAME @
+```
 
-#### Mail configuration
+#### Email
+```bash
 @ 900 IN MX 10 domain.tld. (Minimal)
 @ 900 IN TXT "v=spf1 a mx -all"
 ```
 
-<div class="alert alert-warning"><b>Warning:</b> replace "domain.tld" with your own domain, and update IP samples values with your server IP address.</div>
+#### Set up
+Replace:
+- "`domain.tld`" with your own domain preserving the dot at the end.
+-  IP samples values with your server IP addresses:
+ * `111.222.333.444`: [IPv4](http://ip.yunohost.org/).
+ * `2001:AABB:CCDD:EEFF:1122:3344:5566:7788`: [IPv6](http://ip6.yunohost.org/).
 
-<div class="alert alert-info"><b>To begin:</b> lines with "(Minimal)" are the minimal required DNS entries to make works web, email and XMPP.</div>
+<div class="alert alert-info"><b>To begin:</b> lines with "(Minimal)" are the minimal required DNS entries to make works redirection from the domain name to the IP adress, XMPP and email.</div>
 
 <div class="alert alert-warning"><b>Warning:</b> <b>@</b> is the default domain name currently defined, some registrar (like OVH) does not accept it, so replace @ by your domain name (domain.tld**.**) with a dot at the end.</div>