wip: refactor
docs: update explanation