Docs: Improve the usefulness and accuracy of the file header for wp-cron.php.

DrewAPicture · DrewAPicture · commit 6ebef9f76f2b · 2017-08-20T04:36:39.000Z
Props stevenlinx for the initial patch. Fixes #31401. git-svn-id: https://develop.svn.wordpress.org/trunk@41276 602fd350-edb4-49c9-b593-d223f7449a82
diff --git a/src/wp-cron.php b/src/wp-cron.php
@@ -1,7 +1,14 @@
 <?php
 /**
- * WordPress Cron Implementation for hosts, which do not offer CRON or for which
- * the user has not set up a CRON job pointing to this file.
+ * A pseudo-CRON daemon for scheduling WordPress tasks
+ *
+ * WP Cron is triggered when the site receives a visit. In the scenario
+ * where a site may not receive enough visits to execute scheduled tasks
+ * in a timely manner, this file can be called directly or via a server
+ * CRON daemon for X number of times.
+ *
+ * Defining DISABLE_WP_CRON as true and calling this file directly are
+ * mutually exclusive and the latter does not rely on the former to work.
  *
  * The HTTP request to this file will not slow down the visitor who happens to
  * visit when the cron job is needed to run.
