tidy up and add to the tour

@takluyver found some typos which I fixed now