changes as per review comments

Author: reshmabidikar

source/includes/_aviate-catalog.md

@@ -300,10 +300,12 @@ If successful, returns a status code of 200 and a `PlanData` list.
 
 ### Delete Product
 
-Deletes the specified product. If `deleteAllPlans` is specified, deletes all the plans corresponding to the product.
+Deletes the specified product. If `deleteAllPlans` is specified, hard deletes all the plans corresponding to the product.
 
 **Note:** Since this is an irreversible operation, the query parameter `force=true` must be specified to proceed with the deletion.
 
+**Note:** Deleting a plan hard deletes it from the database and hence should be done with caution.
+
 **HTTP Request**
 
 `DELETE /plugins/aviate-plugin/v1/catalog/product/{productName}/deleteProduct`
@@ -1068,6 +1070,8 @@ Deletes the latest version of the plan. If `allVersions=true` is specified, dele
 
 **Note:** Since this is an irreversible operation, the query parameter `force=true` must be specified to proceed with the deletion.
 
+**Note:** Retiring a plan simply marks it as "retired" in the database and prevents creating new subscriptions corresponding to the plan. On the other hand, deleting a plan hard deletes it from the database and hence should be done with caution.
+
 **HTTP Request**
 
 `DELETE /plugins/aviate-plugin/v1/catalog/{planName}/deletePlan`