Merge pull request #5241 from xing-yang/dev_guide

Add CSI driver doc to developer guide

Author: k8s-ci-robot

contributors/devel/README.md

@@ -100,6 +100,11 @@ See the [kubernetes/release](https://github.com/kubernetes/release) repository f
 * **Structured Logging migration instructions** [migration-to-structured-logging.md](sig-instrumentation/migration-to-structured-logging.md)
 
 ### SIG Storage
+* **NOTE** Flexvolume is deprecated. Out-of-tree CSI driver is the recommended way to write volume drivers in Kubernetes. See this doc [here]( https://github.com/kubernetes/community/blob/master/sig-storage/volume-plugin-faq) for more information.
+
+* **CSI Drivers Doc** [CSI drivers doc](https://kubernetes-csi.github.io/docs/)
+  This site documents how to develop, deploy, and test a [Container Storage Interface](https://github.com/container-storage-interface/spec/blob/master/spec.md) (CSI) driver on Kubernetes.
+
 * **Flexvolume** [flexvolume.md](sig-storage/flexvolume.md)
   Flexvolume enables users to write their own drivers and add support for their volumes in Kubernetes.
 

contributors/devel/sig-storage/flexvolume.md

@@ -1,5 +1,7 @@
 # Flexvolume
 
+**NOTE:** Flexvolume is deprecated. Out-of-tree CSI driver is the recommended way to write volume drivers in Kubernetes. See this doc [here]( https://github.com/kubernetes/community/blob/master/sig-storage/volume-plugin-faq) for more information.
+
 Flexvolume enables users to write their own drivers and add support for their volumes in Kubernetes. Vendor drivers should be installed in the volume plugin path on every node, and on master if the driver requires attach capability (unless `--enable-controller-attach-detach` Kubelet option is set to false, but this is highly discouraged because it is a legacy mode of operation).
 
 Flexvolume is a GA feature from Kubernetes 1.8 release onwards.