comments from draft PR

Author: cmsdroff

rmo/notification/v1/rmo_ntf_v1.0.0.yaml

@@ -7,7 +7,8 @@ info:
   description: |
     API specification issued by DCSA.org.
 
-    Operational Reefer Monitoring Notifications for [DCSA OpenAPI specification for Operational Reefer Monitoring](https://app.swaggerhub.com/apis/dcsaorg/DCSA_RMO/1.0.0-Beta-1) is a lightweight notification based on [CloudEvents](https://cloudevents.io/). The `POST` endPoint of the consumer is called whenever a `Reefer` that is being subscribed to changes state or is updated.
+    Operational Reefer Monitoring Notifications for [DCSA OpenAPI specification for Operational Reefer Monitoring](https://app.swaggerhub.com/apis/dcsaorg/DCSA_RMO/1.0.0-Beta-1) is a lightweight notification based on [CloudEvents](https://cloudevents.io/). 
+    The `POST` endpoint of the consumer is called whenever a `Reefer` that is being subscribed to meets the agreed notification criteria.
 
     Subscribing to notification is done outside scope of this API.
 
@@ -32,7 +33,7 @@ paths:
       summary: Send a new Operational Reefer Notification
       operationId: operational-reefer-notifications
       description: |
-        Creates a new [`Operational Reefer Notification`](#/OperationalReeferNotification). This endPoint is called whenever a `Reefer` that a consumer has subscribed to changes state or is updated.
+        Creates a new [`Operational Reefer Notification`](#/OperationalReeferNotification). This endpoint of the consumer is called whenever a `Reefer` that is being subscribed to meets the agreed notification criteria.
       parameters:
         - name: API-Version
           in: header