update docs for v1.0.0; #32