doc: refine doc

README.md

@@ -20,8 +20,8 @@ This driver allows Kubernetes to access [SMB](https://wiki.wireshark.org/SMB) se
 Please refer to `smb.csi.k8s.io` [driver parameters](./docs/driver-parameters.md)
 
 ### Install driver on a Kubernetes cluster
- - install by [kubectl](./docs/install-smb-csi-driver.md)
- - install by [helm charts](./charts)
+ - install via [helm charts](./charts)
+ - install via [kubectl](./docs/install-smb-csi-driver.md)
 
 ### Examples
  - [How to Use the Windows CSI Proxy and CSI SMB Driver for Kubernetes](https://www.phillipsj.net/posts/how-to-use-the-windows-csi-proxy-and-csi-smb-driver-for-kubernetes/)

deploy/example/e2e_usage.md

@@ -89,6 +89,8 @@ Filesystem                                    Size  Used Avail Use% Mounted on
 apiVersion: v1
 kind: PersistentVolume
 metadata:
+  annotations:
+    pv.kubernetes.io/provisioned-by: smb.csi.k8s.io
   name: pv-smb
 spec:
   capacity:
@@ -103,7 +105,9 @@ spec:
   csi:
     driver: smb.csi.k8s.io
     readOnly: false
-    volumeHandle: unique-volumeid  # make sure it's a unique id in the cluster
+    # volumeHandle format: {smb-server-address}#{sub-dir-name}#{share-name}
+    # make sure this value is unique for every share in the cluster
+    volumeHandle: smb-server.default.svc.cluster.local/share##
     volumeAttributes:
       source: "//smb-server-address/sharename"
     nodeStageSecretRef:

deploy/example/smb-provisioner/pv-smb-csi.yaml

@@ -2,6 +2,8 @@
 apiVersion: v1
 kind: PersistentVolume
 metadata:
+  annotations:
+    pv.kubernetes.io/provisioned-by: smb.csi.k8s.io
   name: pv-smb
 spec:
   capacity:
@@ -16,7 +18,9 @@ spec:
   csi:
     driver: smb.csi.k8s.io
     readOnly: false
-    volumeHandle: unique-volumeid  # make sure it's a unique id in the cluster
+    # volumeHandle format: {smb-server-address}#{sub-dir-name}#{share-name}
+    # make sure this value is unique for every share in the cluster
+    volumeHandle: smb-server.default.svc.cluster.local/share##
     volumeAttributes:
       source: "//smb-server.default.svc.cluster.local/share"
     nodeStageSecretRef: