Document the batch scheduler and parallel launcher internal APIs

[vkarak]

Adding support for more schedulers and parallel launchers is a recurring issue, so it'd be helpful if we document explicitly the corresponding API, as well as how ReFrame uses that API and what expects from each method.