doc: add detailed scheduler documentation

I'll remove it above if that's OK with you.