make the docs marginally more accurate