numerous changes to /docs