politeness docs updated