Если адресуемый мыслит и изъясняется так же, то он не будет ничего объяснять, просто пошлёт. Поэтому, очевидно, правильнее было начать вежливо типа "объясни что за решение и почему"
Если решение не нравится смотрящему на код, то ни документация, ни тесты могут не помочь :)
Не нравиться может в разной степени. Лично мне совсем не нравится, когда код и непонятен, и не документирован. А непонятен он обычно чаще, чем понятен.