a couple improvements and the first set of code examples