Interleave doctest examples w/ API ref docs.#1150

tseaver wants to merge 1 commit intogoogleapis:mastergoogleapis/google-cloud-python:masterfrom

tseaver:1141-pubsub_examples_in_apirefCopy head branch name to clipboard