docs(metadata_expert): warn on add_enum_def that the enum cannot be removed (ISSUE-125)

The warning belongs on the method a caller reaches first, not only on delete_enum_def. Also notes on add_type_def that
only entity types have been verified live.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Signed-off-by: Dan Wolfson <dan.wolfson@pdr-associates.com>

Author: dwolfson

pyegeria/omvs/metadata_expert.py

@@ -4404,6 +4404,11 @@ async def _async_add_enum_def(self, body: dict | OpenMetadataEnumDef) -> str | d
         Add a new enum definition, which can then be used as the type of attributes in new type definitions.
         Async version.
 
+        .. warning::
+           An enum added through the API cannot be removed again: ``delete_enum_def`` currently fails against
+           Egeria with a 500 "unknown TypeDef" (an Egeria server bug, ISSUE-125, reproduced on Egeria main
+           449ad06894, and the enum survives a restart). Do not create throwaway enums on a shared platform.
+
         Parameters
         ----------
         body : dict | OpenMetadataEnumDef
@@ -4433,7 +4438,8 @@ async def _async_add_enum_def(self, body: dict | OpenMetadataEnumDef) -> str | d
 
     @dynamic_catch
     def add_enum_def(self, body: dict | OpenMetadataEnumDef) -> str | dict:
-        """Add a new enum definition, which can then be used as the type of attributes in new type definitions."""
+        """Add a new enum definition, which can then be used as the type of attributes in new type definitions.
+        Note: it cannot be removed again through the API (ISSUE-125); see the async version's warning."""
         loop = asyncio.get_event_loop()
         return loop.run_until_complete(self._async_add_enum_def(body))
 
@@ -4443,6 +4449,10 @@ async def _async_add_type_def(self, body: dict | OpenMetadataTypeDef) -> str | d
         Add a new type definition for an entity, relationship or classification. Links to other types - the
         supertype, attribute types, relationship ends - only need the name of the type. Async version.
 
+        .. note::
+           Verified against a live server for entity types (with primitive and enum attributes). Relationship and
+           classification definitions go through the same code and models but have not been exercised live.
+
         Parameters
         ----------
         body : dict | OpenMetadataTypeDef