Doc: scheduler: update comments for order_then_probes()
I also tested that the commented code compiles