TPT-1936: Added documentation for object/volume.py (#272)

## 📝 Description

Added documentation for `object/volume.py`

## ✔️ How to Test

`pytest test`

Ticket: TPT-1936

Author: ezilber-akamai-zz

linode_api4/objects/volume.py

@@ -3,6 +3,13 @@
 
 
 class Volume(Base):
+    """
+    A single Block Storage Volume. Block Storage Volumes are persistent storage devices
+    that can be attached to a Compute Instance and used to store any type of data.
+
+    API Documentation: https://www.linode.com/docs/api/volumes/#volume-view
+    """
+
     api_endpoint = "/volumes/{id}"
 
     properties = {
@@ -22,7 +29,17 @@ class Volume(Base):
 
     def attach(self, to_linode, config=None):
         """
-        Attaches this Volume to the given Linode
+        Attaches this Volume to the given Linode.
+
+        API Documentation: https://www.linode.com/docs/api/volumes/#volume-attach
+
+        :param to_linode: The ID or object of the Linode to attach the volume to.
+        :type to_linode: Union[Instance, int]
+
+        :param config: The ID or object of the Linode Config to include this Volume in.
+                       Must belong to the Linode referenced by linode_id.
+                       If not given, the last booted Config will be chosen.
+        :type config: Union[Config, int]
         """
         result = self._client.post(
             "{}/attach".format(Volume.api_endpoint),
@@ -50,6 +67,11 @@ def attach(self, to_linode, config=None):
     def detach(self):
         """
         Detaches this Volume if it is attached
+
+        API Documentation: https://www.linode.com/docs/api/volumes/#volume-detach
+
+        :returns: Returns true if operation was successful
+        :rtype: bool
         """
         self._client.post("{}/detach".format(Volume.api_endpoint), model=self)
 
@@ -58,6 +80,14 @@ def detach(self):
     def resize(self, size):
         """
         Resizes this Volume
+
+        API Documentation: https://www.linode.com/docs/api/volumes/#volume-resize
+
+        :param size: The Volume’s size, in GiB.
+        :type size: int
+
+        :returns: Returns true if operation was successful
+        :rtype: bool
         """
         result = self._client.post(
             "{}/resize".format(Volume.api_endpoint),
@@ -73,9 +103,13 @@ def clone(self, label):
         """
         Clones this volume to a new volume in the same region with the given label
 
+        API Documentation: https://www.linode.com/docs/api/volumes/#volume-clone
+
         :param label: The label for the new volume.
+        :type label: str
 
         :returns: The new volume object.
+        :rtype: Volume
         """
         result = self._client.post(
             "{}/clone".format(Volume.api_endpoint),