doc: add detailed scheduler documentation

let's call it 'cooperative'.