More comprehensive documentation on scheduler
Merge pull request #12899 from cachedout/schedule_doc

More comprehensive documentation on scheduler