dougwilson docs: update wording to reflect specification