DOC: fix builing of gbq docs

This fixes some build warnings in de gbq docs after merging #5179 (``` is markdown syntax + wrong internal reference).

And in the same time I corrected some minor numpydoc docstring things.