!28311 Add description of enum class

Merge pull request !28311 from shenwei41/code_docs_api

mindspore/python/mindspore/dataset/engine/datasets.py

@@ -100,7 +100,12 @@ OffloadToManualOffloadMode = {
 
 
 class Shuffle(str, Enum):
-    """Specify the shuffle mode."""
+    """Specify the shuffle mode.
+
+    - GLOBAL: Shuffle both the files and samples.
+    - FILES: Shuffle files only.
+    - INFILE: Shuffle data within each file.
+    """
     GLOBAL: str = "global"
     FILES: str = "files"
     INFILE: str = "infile"

mindspore/python/mindspore/dataset/engine/graphdata.py

@@ -35,6 +35,9 @@ from .validators import check_gnn_graphdata, check_gnn_get_all_nodes, check_gnn_
 class SamplingStrategy(IntEnum):
     """
     Specifies the sampling strategy when execute `get_sampled_neighbors`.
+
+    - RANDOM: Random sampling with replacement.
+    - EDGE_WEIGHT: Sampling with edge weight as probability.
     """
     RANDOM = 0
     EDGE_WEIGHT = 1
@@ -49,6 +52,10 @@ DE_C_INTER_SAMPLING_STRATEGY = {
 class OutputFormat(IntEnum):
     """
     Specifies the output storage format when execute `get_all_neighbors`.
+
+    - NORMAL: Normal format.
+    - COO: COO format.
+    - CSR: CSR format.
     """
     NORMAL = 0
     COO = 1