diff --git a/doc/source/deploy-on-kubernetes.rst b/doc/source/deploy-on-kubernetes.rst
index 9a00f3218..838d35971 100644
--- a/doc/source/deploy-on-kubernetes.rst
+++ b/doc/source/deploy-on-kubernetes.rst
@@ -19,12 +19,15 @@ This document assumes that you have access to a Kubernetes cluster and have
 first walk you through how to deploy a Ray cluster on your existing Kubernetes
 cluster, then explore a few different ways to run programs on the Ray cluster.
 
-The configuration ``yaml`` files here are provided as examples to get you
-started. At a minimum you will probably want to build and use your own
-container images, add more worker nodes to the cluster (or use the
-`Kubernetes Horizontal Pod Autoscaler`_), and change the resource requests for
-the head and worker nodes. Refer to the provided ``yaml`` files to be sure that
-you maintain important configuration options for Ray to function properly.
+The configuration ``yaml`` files used here are provided in the `Ray repository`_
+as examples to get you started. When deploying real applications, you will probably
+want to build and use your own container images, add more worker nodes to the
+cluster (or use the `Kubernetes Horizontal Pod Autoscaler`_), and change the
+resource requests for the head and worker nodes. Refer to the provided ``yaml``
+files to be sure that you maintain important configuration options for Ray to
+function properly.
+
+.. _`Ray repository`: https://github.com/ray-project/ray/tree/master/doc/kubernetes
 
 Creating a Ray Namespace
 ------------------------