diff --git a/doc/README.md b/doc/README.md
index bcbf648bca96..256c436e5aa1 100644
--- a/doc/README.md
+++ b/doc/README.md
@@ -69,7 +69,7 @@ Plugins
 * [uri-blocker](plugins/uri-blocker.md): Block client request by URI.
 * [oauth](plugins/oauth.md): Provides OAuth 2 authentication and introspection.
 
-Deploy to the Cloud
+Deploy
 =======
 
 ### AWS
@@ -77,3 +77,8 @@ Deploy to the Cloud
 The recommended approach is to deploy APISIX with [AWS CDK](https://aws.amazon.com/cdk/) on [AWS Fargate](https://aws.amazon.com/fargate/) which helps you decouple the APISIX layer and the upstream layer on top of a fully-managed and secure serverless container compute environment with autoscaling capabilities.
 
 See [this guide](https://github.com/pahud/cdk-samples/blob/master/typescript/apisix/README.md) by [Pahud Hsieh](https://github.com/pahud) and learn how to provision the recommended architecture 100% in AWS CDK.
+
+### Kubernetes
+
+See [this guide](../kubernetes/README.md) and learn how to deploy apisix in Kubernetes.
+
diff --git a/kubernetes/README.md b/kubernetes/README.md
index 3d914e7d3046..30f299d99415 100644
--- a/kubernetes/README.md
+++ b/kubernetes/README.md
@@ -16,6 +16,12 @@
 # limitations under the License.
 #
 -->
+### kubernetes
+
+There are some yaml files for deploying apisix in Kubernetes.
+
+### Prerequisites
+- Install etcd
 
 ### Usage