changes addressing feedback to the new docs.