more updates to docs for v 1.0.0 release