Improve cron state documentation

Instead of a bolded "Caution" before a sentence explaining a common
pitfall of using this state, use a sphinx "warning" directive to draw
attention to this important information.
clarify cron docstring
Merge pull request #9840 from terminalmage/docs

Improve cron state documentation