My feeling is the author seems pretty open to criticism. You should open a PR incorporating your reasoning into the document. Be respectful but make it better.

My feeling is the author seems pretty open to criticism. You should open a PR incorporating your reasoning into the document. Be respectful but make it better. I'd hope the best ideas would win out but then again the author has the authority to merge or not. To the author maybe you should give one other person you respect whose opinion differs from yours the ability to merge PRS as well. Maybe...