From ba46a498579165e220bcbfaaba9aa91fd521e5ea Mon Sep 17 00:00:00 2001
From: Yury Tsarev <yury.tsarev@absa.africa>
Date: Fri, 16 Oct 2020 10:54:12 +0200
Subject: [PATCH] Add short tutorial on how to create NS record

---
 README.md                   |  1 +
 docs/tutorials/ns-record.md | 23 +++++++++++++++++++++++
 2 files changed, 24 insertions(+)
 create mode 100644 docs/tutorials/ns-record.md

diff --git a/README.md b/README.md
index 639bfbd34..16a90bb77 100644
--- a/README.md
+++ b/README.md
@@ -140,6 +140,7 @@ The following tutorials are provided:
 * [Linode](docs/tutorials/linode.md)
 * [Nginx Ingress Controller](docs/tutorials/nginx-ingress.md)
 * [NS1](docs/tutorials/ns1.md)
+* [NS Record Creation with CRD Source](docs/tutorials/ns-record.md)
 * [OpenStack Designate](docs/tutorials/designate.md)
 * [Oracle Cloud Infrastructure (OCI) DNS](docs/tutorials/oracle.md)
 * [PowerDNS](docs/tutorials/pdns.md)
diff --git a/docs/tutorials/ns-record.md b/docs/tutorials/ns-record.md
new file mode 100644
index 000000000..d1060378f
--- /dev/null
+++ b/docs/tutorials/ns-record.md
@@ -0,0 +1,23 @@
+# Creating NS record with CRD source
+
+You can create NS records with the help of [CRD source](/docs/contributing/crd-source.md)
+and `DNSEndpoint` CRD.
+
+Consider the following example
+
+```yaml
+apiVersion: externaldns.k8s.io/v1alpha1
+kind: DNSEndpoint
+metadata:
+  name: ns-record
+spec:
+  endpoints:
+  - dnsName: zone.example.com
+    recordTTL: 300
+    recordType: NS
+    targets:
+    - ns1.example.com
+    - ns2.example.com
+```
+
+After instantiation of this Custom Resource external-dns will create NS record with the help of configured provider, e.g. `aws`