Reformatting to have an intro, conventions, and metrics, with references and raises for #69
Adding raises to validators #69