diff --git a/deploy/cephfs/kubernetes/cephfs.md b/deploy/cephfs/kubernetes/cephfs.md
new file mode 120000
index 000000000..e05eaa04c
--- /dev/null
+++ b/deploy/cephfs/kubernetes/cephfs.md
@@ -0,0 +1 @@
+../../../docs/cephfs/deploy.md
\ No newline at end of file
diff --git a/deploy/rbd/kubernetes/rbd.md b/deploy/rbd/kubernetes/rbd.md
new file mode 120000
index 000000000..3ae0050c7
--- /dev/null
+++ b/deploy/rbd/kubernetes/rbd.md
@@ -0,0 +1 @@
+../../../docs/rbd/deploy.md
\ No newline at end of file
diff --git a/docs/deploy-cephfs.md b/docs/cephfs/deploy.md
similarity index 100%
rename from docs/deploy-cephfs.md
rename to docs/cephfs/deploy.md
diff --git a/docs/disaster-recovery.md b/docs/csi-addons/disaster-recovery.md
similarity index 100%
rename from docs/disaster-recovery.md
rename to docs/csi-addons/disaster-recovery.md
diff --git a/docs/ceph-mount-corruption.md b/docs/design/proposals/ceph-mount-corruption.md
similarity index 100%
rename from docs/ceph-mount-corruption.md
rename to docs/design/proposals/ceph-mount-corruption.md
diff --git a/docs/cephfs-snapshot-backed-volumes.md b/docs/design/proposals/cephfs-snapshot-backed-volumes.md
similarity index 100%
rename from docs/cephfs-snapshot-backed-volumes.md
rename to docs/design/proposals/cephfs-snapshot-backed-volumes.md
diff --git a/docs/rbd-nbd.md b/docs/design/proposals/rbd-nbd.md
similarity index 100%
rename from docs/rbd-nbd.md
rename to docs/design/proposals/rbd-nbd.md
diff --git a/docs/deploy-rbd.md b/docs/rbd/deploy.md
similarity index 100%
rename from docs/deploy-rbd.md
rename to docs/rbd/deploy.md