docs: Add documentation for enums (#131)

* 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: https://github.com/googleapis/googleapis-gen/commit/0080f830dec37c3384157082bce279e37079ea58
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>

google/cloud/source_context_v1/types/source_context.py

@@ -129,7 +129,22 @@ class AliasContext(proto.Message):
     """
 
     class Kind(proto.Enum):
-        r"""The type of an Alias."""
+        r"""The type of an Alias.
+
+        Values:
+            ANY (0):
+                Do not use.
+            FIXED (1):
+                Git tag
+            MOVABLE (2):
+                Git branch
+            OTHER (4):
+                OTHER is used to specify non-standard
+                aliases, those not of the kinds above. For
+                example, if a Git repo has a ref named
+                "refs/foo/bar", it is considered to be of kind
+                OTHER.
+        """
         ANY = 0
         FIXED = 1
         MOVABLE = 2