adjust docs to reflect new changes.