doc: add detailed scheduler documentation

Ok.