docs: fixed outdated scheduler docstrings

[jstucke]

and also fixed some typos, added missing commas and improved the wording (to make them easier to understand)