chore: update docs for too-wordy