[andreasvc]

I would do simply """f docstring\n%s""" % _shared_docstring, no need for a separate concatenation. However, I wonder whether sphinx would handle this.

[shoyer]

This sort of thing works fine. We use it for pandas all the time.