docs: add notes about deprecating VolumeSnapshot functions (#2929)

Signed-off-by: Daniil Fedotov <[email protected]>
Co-authored-by: mergify[bot] <37929162+mergify[bot]@users.noreply.github.com>

ROADMAP.md

@@ -1 +1 @@
-Roadmap was moved to [the Wiki page](https://github.com/kanisterio/kanister/wiki/Roadmap)
+Roadmap was moved to [the Wiki page](https://github.com/kanisterio/kanister/wiki/Roadmap)

docs/functions.md

@@ -752,6 +752,12 @@ with an application. It takes individual snapshot of each PVC which can
 be then restored later. It generates an output that contains the
 Snapshot info required for restoring PVCs.
 
+::: tip WARNING
+
+The *CreateVolumeSnapshot* will be deprecated soon. We recommend using [CreateCSISnapshot](#createcsisnapshot) instead.
+CSI snapshotting should have better support for underlying storage providers.
+:::
+
 ::: tip NOTE
 
 Currently we only support PVC snapshots on AWS EBS. Support for more
@@ -801,6 +807,12 @@ This function is used to wait for completion of snapshot operations
 initiated using the [CreateVolumeSnapshot](#createvolumesnapshot) function.
 function.
 
+::: tip WARNING
+
+   The *WaitForSnapshotCompletion* will be deprecated soon together with [CreateVolumeSnapshot](#createvolumesnapshot).
+   We recommend using [CreateCSISnapshot](#createcsisnapshot) instead, which will wait for completion by default.
+:::
+
 Arguments:
 
   | Argument  | Required | Type   | Description |
@@ -813,6 +825,12 @@ This function is used to restore one or more PVCs of an application from
 the snapshots taken using the [CreateVolumeSnapshot](#createvolumesnapshot) function.
 It deletes old PVCs, if present and creates new PVCs from the snapshots taken earlier.
 
+::: tip WARNING
+
+   The *CreateVolumeFromSnapshot* will be deprecated soon together with [CreateVolumeSnapshot](#createvolumesnapshot). We recommend using CSI snapshotting functions ([CreateCSISnapshot](#createcsisnapshot) and [RestoreCSISnapshot](#restorecsisnapshot)) instead.
+   CSI snapshotting should have better support for underlying storage providers.
+:::
+
 Arguments:
 
   | Argument  | Required | Type   | Description |
@@ -854,6 +872,13 @@ by the [CreateVolumeSnapshot](#createvolumesnapshot) function.
 This function is used to delete snapshots of PVCs taken using the
 [CreateVolumeSnapshot](#createvolumesnapshot) function.
 
+
+::: tip WARNING
+
+   The *DeleteVolumeSnapshot* will be deprecated soon together with [CreateVolumeSnapshot](#createvolumesnapshot). We recommend using CSI snapshotting functions ([CreateCSISnapshot](#createcsisnapshot) and [DeleteCSISnapshot](#deletecsisnapshot)) instead.
+   CSI snapshotting should have better support for underlying storage providers.
+:::
+
 Arguments:
 
   | Argument  | Required | Type   | Description |

releasenotes/notes/deprecate-volume-snapshot-9fdf5b18604bd734.yaml

@@ -0,0 +1,3 @@
+---
+deprecations:
+  - Volume snapshot function such as CreateVolumeSnapshot, WaitForSnapshotCompletion, CreateVolumeFromSnapshot and DeleteVolumeSnapshot in favour of CSI snapshot functions