refactor docu - insert usage and extraction pattern