From 60bfa9c7c36e2615f9741d91737e911ff36a7aff Mon Sep 17 00:00:00 2001
From: Anne-Marie <102995847+am-stead@users.noreply.github.com>
Date: Thu, 6 Nov 2025 10:38:24 +0000
Subject: [PATCH] Propose fix to Dependabot documentation (#58315)

---
 .../dependabot-options-reference.md                | 14 ++++++++++----
 data/features/dependabot-schedule-updates.yml      |  6 ++++++
 2 files changed, 16 insertions(+), 4 deletions(-)
 create mode 100644 data/features/dependabot-schedule-updates.yml

diff --git a/content/code-security/dependabot/working-with-dependabot/dependabot-options-reference.md b/content/code-security/dependabot/working-with-dependabot/dependabot-options-reference.md
index 97d2c450e4..2d3ab1ad4c 100644
--- a/content/code-security/dependabot/working-with-dependabot/dependabot-options-reference.md
+++ b/content/code-security/dependabot/working-with-dependabot/dependabot-options-reference.md
@@ -607,7 +607,9 @@ Reviewers must have at least read access to the repository.
 | `interval` | **Required.** Defines the frequency for {% data variables.product.prodname_dependabot %}. |
 | `day` | Specify the day to run for a **weekly** interval. |
 | `time` | Specify the time to run. |
+| {% ifversion dependabot-schedule-updates %} |
 | `cronjob` | Defines the cron expression if the interval type is `cron`. |
+| {% endif %} |
 | `timezone` | Specify the timezone of the `time` value.  |
 
 {% ifversion fpt or ghec %}
@@ -630,18 +632,18 @@ Each package manager **must** define a schedule interval.
 
 ### `interval`
 
-Supported values: `daily`, `weekly`, `monthly`, or `cron`
+Supported values: `daily`, `weekly`, `monthly`{% ifversion dependabot-schedule-updates %}, or `cron`{% endif %}
 
 Each package manager **must** define a schedule interval.
 
 * Use `daily` to run on every weekday, Monday to Friday.
 * Use `weekly` to run once a week, by default on Monday.
-* Use `monthly` to run on the first day of each month.
-* Use `cron` for cron expression based scheduling option. See [`cronjob`](#cronjob).
+* Use `monthly` to run on the first day of each month.{% ifversion dependabot-schedule-updates %}
+* Use `cron` for cron expression based scheduling option. See [`cronjob`](#cronjob).{% endif %}
 
 {% endif %}
 
-By default, {% data variables.product.prodname_dependabot %} randomly assigns a time to apply all the updates in the configuration file. You can use the `time` and `timezone` parameters to set a specific runtime for all intervals.  If you use a `cron` interval, you can define the update time with a `cronjob` expression.
+By default, {% data variables.product.prodname_dependabot %} randomly assigns a time to apply all the updates in the configuration file. You can use the `time` and `timezone` parameters to set a specific runtime for all intervals.  {% ifversion dependabot-schedule-updates %}If you use a `cron` interval, you can define the update time with a `cronjob` expression.{% endif %}
 
 ### `day`
 
@@ -655,6 +657,8 @@ Format: `hh:mm`
 
 Optionally, run all updates for a package manager at a specific time of day. By default, times are interpreted as UTC.
 
+{% ifversion dependabot-schedule-updates %}
+
 ### `cronjob`
 
 Supported values: Valid cron expression in cron syntax or natural expression.
@@ -684,6 +688,8 @@ updates:
       cronjob: "0 9 * * *"
 ```
 
+{% endif %}
+
 ### `timezone`
 
 Specify a time zone for the `time` value.
diff --git a/data/features/dependabot-schedule-updates.yml b/data/features/dependabot-schedule-updates.yml
new file mode 100644
index 0000000000..4881433806
--- /dev/null
+++ b/data/features/dependabot-schedule-updates.yml
@@ -0,0 +1,6 @@
+# Reference: #17004
+# Dependabot `schedule` enhancements [GA]
+versions:
+  fpt: '*'
+  ghec: '*'
+  ghes: '> 3.17'