doc: add detailed scheduler documentation
Merge pull request #1441 from LudwigOrtmann/scheduler_documentation

doc: add detailed scheduler documentation