Improve usability and add documentation

[yfcai]

The README should provide sufficient information for a new graduate student to set up scheduling without talking to anybody.

The code should have enough comments to be understood by a Scala programmer.