update docs and add some periods to my sentences bc Professor Brian Ripley said sentences should end with periods!