Need better documentation to show importance of checking for args while using wp_schedule_event and wp_next_scheduled

[digamberpradhan]

While the user notes ​https://developer.wordpress.org/reference/functions/wp_next_scheduled/#user-contributed-notes do relay the importance. I believe it is important that the documentation also be more clear about the issue.

When coded incorrectly something like

function schedule_my_event(){
if ( ! wp_next_scheduled( 'myevent' ) ) { // This will always be false
    wp_schedule_event( time(), 'daily', 'myevent', array( false ) );
}
}

add_action('init','schedule_my_event');

It's potentially disastrous for a site. The cron value in the options would keep on increasing until the database could no longer withstand it.

So keeping that in mind I feel the documentation for both wp_next_scheduled and wp_schedule_event should highlight this point more.

[ovidiul]

adding missing documentation text for wp_schedule_event and wp_next_scheduled functions

Trac ticket: [](https://core.trac.wordpress.org/ticket/43801)