Merge pull request #4490 from github/openapi-update-f7d48b7939131bda08c0d11de60e517f7945fbb06a9d8f56f72adde4a3e15113

Update OpenAPI 3.1 Descriptions

Author: shiftkey

descriptions-next/api.github.com/api.github.com.2022-11-28.json

@@ -306613,7 +306613,7 @@
       },
       "billing-usage-report-year": {
         "name": "year",
-        "description": "If specified, only return results for a single year. The value of `year` is an integer with four digits representing a year. For example, `2024`. Default value is the current year.",
+        "description": "If specified, only return results for a single year. The value of `year` is an integer with four digits representing a year. For example, `2025`. Default value is the current year.",
         "in": "query",
         "required": false,
         "schema": {
@@ -306622,7 +306622,7 @@
       },
       "billing-usage-report-month": {
         "name": "month",
-        "description": "If specified, only return results for a single month. The value of `month` is an integer between `1` and `12`.",
+        "description": "If specified, only return results for a single month. The value of `month` is an integer between `1` and `12`. If no year is specified the default `year` is used.",
         "in": "query",
         "required": false,
         "schema": {
@@ -306631,7 +306631,7 @@
       },
       "billing-usage-report-day": {
         "name": "day",
-        "description": "If specified, only return results for a single day. The value of `day` is an integer between `1` and `31`.",
+        "description": "If specified, only return results for a single day. The value of `day` is an integer between `1` and `31`. If no `year` or `month` is specified, the default `year` and `month` are used.",
         "in": "query",
         "required": false,
         "schema": {
@@ -306640,7 +306640,7 @@
       },
       "billing-usage-report-hour": {
         "name": "hour",
-        "description": "If specified, only return results for a single hour. The value of `hour` is an integer between `0` and `23`.",
+        "description": "If specified, only return results for a single hour. The value of `hour` is an integer between `0` and `23`. If no `year`, `month`, or `day` is specified, the default `year`, `month`, and `day` are used.",
         "in": "query",
         "required": false,
         "schema": {

descriptions-next/api.github.com/api.github.com.2022-11-28.yaml

@@ -229528,31 +229528,34 @@ components:
       name: year
       description: If specified, only return results for a single year. The value
         of `year` is an integer with four digits representing a year. For example,
-        `2024`. Default value is the current year.
+        `2025`. Default value is the current year.
       in: query
       required: false
       schema:
         type: integer
     billing-usage-report-month:
       name: month
       description: If specified, only return results for a single month. The value
-        of `month` is an integer between `1` and `12`.
+        of `month` is an integer between `1` and `12`. If no year is specified the
+        default `year` is used.
       in: query
       required: false
       schema:
         type: integer
     billing-usage-report-day:
       name: day
       description: If specified, only return results for a single day. The value of
-        `day` is an integer between `1` and `31`.
+        `day` is an integer between `1` and `31`. If no `year` or `month` is specified,
+        the default `year` and `month` are used.
       in: query
       required: false
       schema:
         type: integer
     billing-usage-report-hour:
       name: hour
       description: If specified, only return results for a single hour. The value
-        of `hour` is an integer between `0` and `23`.
+        of `hour` is an integer between `0` and `23`. If no `year`, `month`, or `day`
+        is specified, the default `year`, `month`, and `day` are used.
       in: query
       required: false
       schema:

descriptions-next/api.github.com/api.github.com.json

@@ -306613,7 +306613,7 @@
       },
       "billing-usage-report-year": {
         "name": "year",
-        "description": "If specified, only return results for a single year. The value of `year` is an integer with four digits representing a year. For example, `2024`. Default value is the current year.",
+        "description": "If specified, only return results for a single year. The value of `year` is an integer with four digits representing a year. For example, `2025`. Default value is the current year.",
         "in": "query",
         "required": false,
         "schema": {
@@ -306622,7 +306622,7 @@
       },
       "billing-usage-report-month": {
         "name": "month",
-        "description": "If specified, only return results for a single month. The value of `month` is an integer between `1` and `12`.",
+        "description": "If specified, only return results for a single month. The value of `month` is an integer between `1` and `12`. If no year is specified the default `year` is used.",
         "in": "query",
         "required": false,
         "schema": {
@@ -306631,7 +306631,7 @@
       },
       "billing-usage-report-day": {
         "name": "day",
-        "description": "If specified, only return results for a single day. The value of `day` is an integer between `1` and `31`.",
+        "description": "If specified, only return results for a single day. The value of `day` is an integer between `1` and `31`. If no `year` or `month` is specified, the default `year` and `month` are used.",
         "in": "query",
         "required": false,
         "schema": {
@@ -306640,7 +306640,7 @@
       },
       "billing-usage-report-hour": {
         "name": "hour",
-        "description": "If specified, only return results for a single hour. The value of `hour` is an integer between `0` and `23`.",
+        "description": "If specified, only return results for a single hour. The value of `hour` is an integer between `0` and `23`. If no `year`, `month`, or `day` is specified, the default `year`, `month`, and `day` are used.",
         "in": "query",
         "required": false,
         "schema": {