fix: omit duplicate wordings

camaraproject · Jun 11, 2024 · 7110b80 · 7110b80
1 parent 95ffd98
commit 7110b80
Show file tree

Hide file tree

Showing 2 changed files with 7 additions and 7 deletions.
diff --git a/code/API_definitions/device-reachability-status-subscription.yaml b/code/API_definitions/device-reachability-status-subscription.yaml
@@ -25,7 +25,7 @@ info:
     These endpoints allow to manage event subscription on reachability device status event.
     The CAMARA subscription model is detailed in the CAMARA API design guideline document and follows CloudEvents specification.
 
-    It is mandatory in the subscription to provide the event `type` subscribed are several are managed in this API.
+    When subscribing, it is mandatory to provide the event `type` you are subscribing to, as multiple subscription-types are managed by this API.
 
     Following event ``type`` are managed for this API:
       - ``org.camaraproject.reachability-status-subscriptions.v0.reachability-data``: Event triggered when the device is connected to the network for Data usage.

diff --git a/code/API_definitions/device-roaming-status-subscriptions.yaml b/code/API_definitions/device-roaming-status-subscriptions.yaml
@@ -25,7 +25,7 @@ info:
     These endpoints allow to manage event subscription on roaming device status event.
     The CAMARA subscription model is detailed in the CAMARA API design guideline document and follows CloudEvents specification.
 
-    It is mandatory in the subscription to provide the event `type` subscribed are several are managed in this API.
+    When subscribing, it is mandatory to provide the event `type` you are subscribing to, as multiple subscription-types are managed by this API.
 
     Following event ``type`` are managed for this API:
       - ``org.camaraproject.roaming-status-subscriptions.v0.roaming-status`` - Event triggered when the device switch from roaming ON to roaming OFF and conversely
@@ -42,7 +42,7 @@ info:
 
     ### Notifications callback
 
-    The  `notifications` callback describes the format of event notifications and expected responses to the messages sent when the event occurs. As for subscription, detailed description of the event notification is provided in the CAMARA API design guideline document.
+    The `notifications` callback describes the format of event notifications and expected responses to the messages sent when the event occurs. As for subscription, detailed description of the event notification is provided in the CAMARA API design guideline document.
 
     **WARNING**: This callback endpoint must be exposed and reachable on the listener side under `notificationUrl` defined in the `webhook` attribute.
 
@@ -77,8 +77,8 @@ paths:
     post:
       tags:
         - Device roaming status subscription
-      summary: "Create a device roaming status event subscription for a device"
-      description: Create a device roaming status event subscription for a device
+      summary: "Create a roaming status event subscription for a device"
+      description: Create a roaming status event subscription for a device
       operationId: createDeviceRoamingStatusSubscription
       parameters:
         - $ref: '#/components/parameters/x-correlator'
@@ -210,7 +210,7 @@ paths:
     get:
       tags:
         - Device roaming status subscription
-      summary: "Retrieve a device roaming status event subscription for a device"
+      summary: "Retrieve a roaming status event subscription for a device"
       operationId: retrieveSubscription
       description: Retrieve a given subscription by ID
       security:
@@ -244,7 +244,7 @@ paths:
     delete:
       tags:
         - Device roaming status subscription
-      summary: "Delete a device roaming status event subscription for a device"
+      summary: "Delete a roaming status event subscription for a device"
       operationId: deleteSubscription
       description: Delete a given subscription by ID
       security: