[refactor] improve docs