diff --git a/specification/consumption/resource-manager/Microsoft.Consumption/stable/2021-10-01/consumption.json b/specification/consumption/resource-manager/Microsoft.Consumption/stable/2021-10-01/consumption.json
index d83a79c41a3e..65aa427e30de 100644
--- a/specification/consumption/resource-manager/Microsoft.Consumption/stable/2021-10-01/consumption.json
+++ b/specification/consumption/resource-manager/Microsoft.Consumption/stable/2021-10-01/consumption.json
@@ -3250,15 +3250,15 @@
       }
     },
     "ReservationRecommendationDetailsCalculatedSavingsProperties": {
-      "description": "Details of estimated savings.",
+      "description": "Details of estimated savings. The costs and savings are estimated for the term.",
       "properties": {
         "onDemandCost": {
-          "description": "The cost without reservation.",
+          "description": "The cost without reservation. Includes hardware and software cost.",
           "type": "number",
           "readOnly": true
         },
         "overageCost": {
-          "description": "The difference between total reservation cost and reservation cost.",
+          "description": "Hardware and software cost of the resources not covered by the reservation.",
           "type": "number",
           "readOnly": true
         },
@@ -3268,12 +3268,12 @@
           "readOnly": true
         },
         "reservationCost": {
-          "description": "The exact cost of the estimated usage using reservation.",
+          "description": "Hardware cost of the resources covered by the reservation.",
           "type": "number",
           "readOnly": true
         },
         "totalReservationCost": {
-          "description": "The cost of the suggested quantity.",
+          "description": "Reservation cost + software cost of the resources covered by the reservation + overage cost.",
           "type": "number",
           "readOnly": true
         },
@@ -3282,7 +3282,7 @@
           "type": "number"
         },
         "savings": {
-          "description": "The amount saved by purchasing the recommended quantity of reservation.",
+          "description": "The amount saved by purchasing the recommended quantity of reservation. This is equal to onDemandCost - totalReservationCost.",
           "type": "number",
           "readOnly": true
         }
@@ -3300,7 +3300,7 @@
           "readOnly": true
         },
         "onDemandRate": {
-          "description": "On demand rate of the resource.",
+          "description": "Hourly on-demand rate of the resource. Includes only hardware rate i.e, software rate is not included.",
           "type": "number",
           "readOnly": true
         },
@@ -3315,7 +3315,7 @@
           "readOnly": true
         },
         "reservationRate": {
-          "description": "Reservation rate of the resource.",
+          "description": "Hourly reservation rate of the resource. Varies based on the term.",
           "type": "number",
           "readOnly": true
         },