update docs to reflect the refactoring