From 86d7dbca0de9ecde168a733a071886eface9be13 Mon Sep 17 00:00:00 2001
From: Niels de Blaauw <niels@level-level.com>
Date: Thu, 31 Oct 2019 12:44:50 +0100
Subject: [PATCH] Adds documentation for WordPress.WP.CronInterval

Update WordPress/Docs/WP/CronIntervalStandard.xml

Co-Authored-By: Juliette <663378+jrfnl@users.noreply.github.com>

Update WordPress/Docs/WP/CronIntervalStandard.xml

Co-Authored-By: Juliette <663378+jrfnl@users.noreply.github.com>

Update WordPress/Docs/WP/CronIntervalStandard.xml

Co-Authored-By: Juliette <663378+jrfnl@users.noreply.github.com>

Update WordPress/Docs/WP/CronIntervalStandard.xml

Co-Authored-By: Juliette <663378+jrfnl@users.noreply.github.com>

Update WordPress/Docs/WP/CronIntervalStandard.xml

Co-Authored-By: Juliette <663378+jrfnl@users.noreply.github.com>

Seperates function definition
---
 WordPress/Docs/WP/CronIntervalStandard.xml | 41 ++++++++++++++++++++++
 1 file changed, 41 insertions(+)
 create mode 100644 WordPress/Docs/WP/CronIntervalStandard.xml

diff --git a/WordPress/Docs/WP/CronIntervalStandard.xml b/WordPress/Docs/WP/CronIntervalStandard.xml
new file mode 100644
index 0000000000..55a9037d47
--- /dev/null
+++ b/WordPress/Docs/WP/CronIntervalStandard.xml
@@ -0,0 +1,41 @@
+<documentation title="Cron interval">
+    <standard>
+    <![CDATA[
+    Cron schedules running more often than once every 15 minutes are discouraged. Crons running that frequently can negatively impact the performance of a site.
+    ]]>
+    </standard>
+    <code_comparison>
+        <code title="Valid: Cron schedule is created to run once every hour.">
+        <![CDATA[
+function adjust_schedules( $schedules ) {
+    $schedules['every_hour'] = array(
+        'interval' => <em>HOUR_IN_SECONDS</em>,
+        'display'  => __( 'Every hour' )
+    );
+    return $schedules;
+} 
+
+add_filter( 
+    'cron_schedules', 
+    'adjust_schedules'
+); 
+        ]]>
+        </code>
+        <code title="Invalid: Cron schedule is added to run more than once per 15 minutes.">
+        <![CDATA[
+function adjust_schedules( $schedules ) {
+    $schedules['every_9_mins'] = array(
+        'interval' => <em>9 * 60</em>,
+        'display'  => __( 'Every 9 minutes' )
+    );
+    return $schedules;
+} 
+
+add_filter( 
+    'cron_schedules', 
+    'adjust_schedules'
+);
+        ]]>
+        </code>
+    </code_comparison>
+</documentation>