docs: Add documentation for enums (#221)

* docs: Add documentation for enums

fix: Add context manager return types

chore: Update gapic-generator-python to v1.8.1
PiperOrigin-RevId: 503210727

Source-Link: googleapis/googleapis@a391fd1

Source-Link: googleapis/googleapis-gen@0080f83
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiMDA4MGY4MzBkZWMzN2MzMzg0MTU3MDgyYmNlMjc5ZTM3MDc5ZWE1OCJ9

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>

packages/google-area120-tables/google/area120/tables_v1alpha1/services/tables_service/client.py

@@ -1617,7 +1617,7 @@ def sample_batch_delete_rows():
             metadata=metadata,
         )
 
-    def __enter__(self):
+    def __enter__(self) -> "TablesServiceClient":
         return self
 
     def __exit__(self, type, value, traceback):

packages/google-area120-tables/google/area120/tables_v1alpha1/types/tables.py

@@ -52,7 +52,15 @@
 
 
 class View(proto.Enum):
-    r"""Column identifier used for the values in the row."""
+    r"""Column identifier used for the values in the row.
+
+    Values:
+        VIEW_UNSPECIFIED (0):
+            Defaults to user entered text.
+        COLUMN_ID_VIEW (1):
+            Uses internally generated column id to
+            identify values.
+    """
     VIEW_UNSPECIFIED = 0
     COLUMN_ID_VIEW = 1
 

packages/google-area120-tables/samples/generated_samples/snippet_metadata_google.area120.tables.v1alpha1.json

@@ -8,7 +8,7 @@
     ],
     "language": "PYTHON",
     "name": "google-area120-tables",
-    "version": "0.11.0"
+    "version": "0.1.0"
   },
   "snippets": [
     {