Update documentation
More comments, and shuffle around the scheduler slightly