Refine rule description

Sophia Marie Terry · Sophia Marie Terry · commit 693f032d08d9 · 2025-08-06T14:31:05.000+01:00
diff --git a/tools/spectral/ipa/rulesets/IPA-104.yaml b/tools/spectral/ipa/rulesets/IPA-104.yaml
@@ -107,8 +107,7 @@ rules:
       ##### Implementation details
       Rule checks for the following conditions:
         - Applies only to GET methods on single resources or singleton resources
-        - Generates the expected OperationId given the resource identifier
-        - Confirms that the existing operationId is compliant with generated IPA Compliant OperationId
+        - Confirms that the existing OperationId is compliant with generated IPA Compliant OperationId
     message: '{{error}} https://mdb.link/mongodb-atlas-openapi-validation#xgen-IPA-104-valid-operation-id'
     severity: warn
     given: '#GetOperationObject'
diff --git a/tools/spectral/ipa/rulesets/IPA-105.yaml b/tools/spectral/ipa/rulesets/IPA-105.yaml
@@ -87,8 +87,7 @@ rules:
       Rule checks for the following conditions:
         - Applies only to GET methods on resource collection paths
         - Ignores singleton resources
-        - Generates the expected OperationId given the resource identifier
-        - Confirms that the existing operationId is compliant with generated IPA Compliant OperationId
+        - Confirms that the existing OperationId is compliant with generated IPA Compliant OperationId
     message: '{{error}} https://mdb.link/mongodb-atlas-openapi-validation#xgen-IPA-105-valid-operation-id'
     severity: warn
     given: '#GetOperationObject'
diff --git a/tools/spectral/ipa/rulesets/IPA-106.yaml b/tools/spectral/ipa/rulesets/IPA-106.yaml
@@ -121,8 +121,7 @@ rules:
       ##### Implementation details
       Rule checks for the following conditions:
         - Applies only to POST methods on resource collection paths
-        - Generates the expected OperationId given the resource identifier
-        - Confirms that the existing operationId is compliant with generated IPA Compliant OperationId
+        - Confirms that the existing OperationId is compliant with generated IPA Compliant OperationId
     message: '{{error}} https://mdb.link/mongodb-atlas-openapi-validation#xgen-IPA-106-valid-operation-id'
     severity: warn
     given: '#CreateOperationObject'
diff --git a/tools/spectral/ipa/rulesets/IPA-107.yaml b/tools/spectral/ipa/rulesets/IPA-107.yaml
@@ -122,8 +122,7 @@ rules:
       ##### Implementation details
       Rule checks for the following conditions:
         - Validation checks the PATCH/PUT methods for single resource paths and [singleton resources](https://go/ipa/113).
-        - Generates the expected OperationId given the resource identifier
-        - Confirms that the existing operationId is compliant with generated IPA Compliant OperationId
+        - Confirms that the existing OperationId is compliant with generated IPA Compliant OperationId
     message: '{{error}} https://mdb.link/mongodb-atlas-openapi-validation#xgen-IPA-107-valid-operation-id'
     severity: warn
     given: '#UpdateOperationObject'
diff --git a/tools/spectral/ipa/rulesets/IPA-108.yaml b/tools/spectral/ipa/rulesets/IPA-108.yaml
@@ -63,8 +63,7 @@ rules:
       ##### Implementation details
       Rule checks for the following conditions:
         - Applies to all DELETE methods for single resource endpoints (with path parameters)
-        - Generates the expected OperationId given the resource identifier
-        - Confirms that the existing operationId is compliant with generated IPA Compliant OperationId
+        - Confirms that the existing OperationId is compliant with generated IPA Compliant OperationId
     message: '{{error}} https://mdb.link/mongodb-atlas-openapi-validation#xgen-IPA-108-valid-operation-id'
     severity: warn
     given: '#DeleteOperationObject'
diff --git a/tools/spectral/ipa/rulesets/IPA-109.yaml b/tools/spectral/ipa/rulesets/IPA-109.yaml
@@ -69,8 +69,7 @@ rules:
       ##### Implementation details
       Rule checks for the following conditions:
         - Applies only to paths containing custom method identifiers (with colon format)
-        - Generates the expected OperationId given the resource identifier and the method name portion following the colon
-        - Confirms that the existing operationId is compliant with generated IPA Compliant OperationId
+        - Confirms that the existing OperationId is compliant with generated IPA Compliant OperationId
     message: '{{error}} https://mdb.link/mongodb-atlas-openapi-validation#xgen-IPA-109-valid-operation-id'
     severity: warn
     given: '$.paths[*][*]'
diff --git a/tools/spectral/ipa/rulesets/README.md b/tools/spectral/ipa/rulesets/README.md
@@ -149,8 +149,7 @@ If the resource is a singleton resource, the last noun may be the plural form of
 ##### Implementation details
 Rule checks for the following conditions:
   - Applies only to GET methods on single resources or singleton resources
-  - Generates the expected OperationId given the resource identifier
-  - Confirms that the existing operationId is compliant with generated IPA Compliant OperationId
+  - Confirms that the existing OperationId is compliant with generated IPA Compliant OperationId
 
 
 
@@ -216,8 +215,7 @@ The noun(s) in the Operation ID should be the collection identifiers from the re
 Rule checks for the following conditions:
   - Applies only to GET methods on resource collection paths
   - Ignores singleton resources
-  - Generates the expected OperationId given the resource identifier
-  - Confirms that the existing operationId is compliant with generated IPA Compliant OperationId
+  - Confirms that the existing OperationId is compliant with generated IPA Compliant OperationId
 
 
 
@@ -308,8 +306,7 @@ The noun(s) in the Operation ID should be the collection identifiers from the re
 ##### Implementation details
 Rule checks for the following conditions:
   - Applies only to POST methods on resource collection paths
-  - Generates the expected OperationId given the resource identifier
-  - Confirms that the existing operationId is compliant with generated IPA Compliant OperationId
+  - Confirms that the existing OperationId is compliant with generated IPA Compliant OperationId
 
 
 
@@ -392,8 +389,7 @@ If the resource is a singleton resource, the last noun may be the plural form of
 ##### Implementation details
 Rule checks for the following conditions:
   - Validation checks the PATCH/PUT methods for single resource paths and [singleton resources](https://go/ipa/113).
-  - Generates the expected OperationId given the resource identifier
-  - Confirms that the existing operationId is compliant with generated IPA Compliant OperationId
+  - Confirms that the existing OperationId is compliant with generated IPA Compliant OperationId
 
 
 
@@ -448,8 +444,7 @@ The noun(s) in the Operation ID should be the collection identifiers from the re
 ##### Implementation details
 Rule checks for the following conditions:
   - Applies to all DELETE methods for single resource endpoints (with path parameters)
-  - Generates the expected OperationId given the resource identifier
-  - Confirms that the existing operationId is compliant with generated IPA Compliant OperationId
+  - Confirms that the existing OperationId is compliant with generated IPA Compliant OperationId
 
 
 
@@ -509,8 +504,7 @@ The noun(s) in the Operation ID should be the collection identifiers from the re
 ##### Implementation details
 Rule checks for the following conditions:
   - Applies only to paths containing custom method identifiers (with colon format)
-  - Generates the expected OperationId given the resource identifier and the method name portion following the colon
-  - Confirms that the existing operationId is compliant with generated IPA Compliant OperationId
+  - Confirms that the existing OperationId is compliant with generated IPA Compliant OperationId
 
 
 
