Fix links and add a few John Deck comments