refactor and document import/update steps