docs: correct claims contradicted by the code

docs: correct claims contradicted by the code #179