diff --git a/contributors/devel/README.md b/contributors/devel/README.md
index 4d748e1a1..ca7f2b8a2 100644
--- a/contributors/devel/README.md
+++ b/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.
 
diff --git a/contributors/devel/sig-storage/flexvolume.md b/contributors/devel/sig-storage/flexvolume.md
index 12c463829..70bed43e2 100644
--- a/contributors/devel/sig-storage/flexvolume.md
+++ b/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.