document implementation mismatch