For many functions, the document is so long that it cannot be displayed in half the screen height, so it is a good choice if document can be displayed in a new Tab.
I tried to change the code in the racer#ShowDocumentation() function from pedit to tab pedit, I get the effect that I'm talking about, so I guess that would work.