From 744dfd34f63c1be141cd1a6cde6aa617d0af7d02 Mon Sep 17 00:00:00 2001
From: "Lubomir I. Ivanov (VMware)" <lubomirivanov@vmware.com>
Date: Wed, 23 May 2018 15:06:07 +0300
Subject: [PATCH] coredns: update notes in administer-cluster/coredns.md

CoreDNS is installed by default in 1.11.
Add notes on how to install kube-dns instead.
---
 .../docs/tasks/administer-cluster/coredns.md  | 20 +++++++------------
 1 file changed, 7 insertions(+), 13 deletions(-)

diff --git a/content/en/docs/tasks/administer-cluster/coredns.md b/content/en/docs/tasks/administer-cluster/coredns.md
index f860b64cdf3d6..0f65e69ce8e53 100644
--- a/content/en/docs/tasks/administer-cluster/coredns.md
+++ b/content/en/docs/tasks/administer-cluster/coredns.md
@@ -6,11 +6,8 @@ min-kubernetes-server-version: v1.9
 content_template: templates/task
 ---
 
-{{< feature-state state="beta" >}}
-
 {{% capture overview %}}
-This page describes how to enable CoreDNS instead of kube-dns for service
-discovery.
+This page describes the CoreDNS upgrade process and how to install kube-dns instead of CoreDNS.
 {{% /capture %}}
 
 {{% capture prerequisites %}}
@@ -19,21 +16,18 @@ discovery.
 
 {{% capture steps %}}
 
-## Installing CoreDNS with kubeadm
-
-In Kubernetes 1.9, [CoreDNS](https://coredns.io) is available as an alpha feature, and
-in Kubernetes 1.10 it is available as a beta feature. In either case, you may install
-it during cluster creation by setting the `CoreDNS` feature gate to `true` during `kubeadm init`:
+## Installing kube-dns with kubeadm
 
+In Kubernetes 1.11, [CoreDNS](https://coredns.io) has graduated to General Availability (GA)
+and is installed by default. To install kube-dns instead, set the `CoreDNS` feature gate
+value to `false`:
 ```
-kubeadm init --feature-gates=CoreDNS=true
+kubeadm init --feature-gates=CoreDNS=false
 ```
 
-This installs CoreDNS instead of kube-dns.
-
 ## Upgrading an Existing Cluster with kubeadm
 
-In Kubernetes 1.10, you can also move to CoreDNS when you use `kubeadm` to upgrade
+In Kubernetes version 1.10 and later, you can also move to CoreDNS when you use `kubeadm` to upgrade
 a cluster that is using `kube-dns`. In this case, `kubeadm` will generate the CoreDNS configuration
 ("Corefile") based upon the `kube-dns` ConfigMap, preserving configurations for federation,
 stub domains, and upstream name server.