doc: add detailed scheduler documentation

Actually you suggested `thread_sleep` as an example above ;-)