Updated introductory docs

Fill in holes in code revealed by working through the docs