Regarding the answer here: How can I programmatically add a rendering to all of my content items?
Personally; I would prefer the Gist reference in the answer to actually be embedded into the post, optionally with a link to the source. One of the basic ideas of Stack Exchange sites is; it puts the question and the full complete (best) answer right next to each other and ideally the answer is comprehensive.
It's absolutely fine, of course, to then add links to additional online resources (in this case, the API guide).
I've proposed the edit. We're a little short on peer reviewers right now (need 500 rep), but pretty soon stuff like this will be trivial for us to manage ourselves :-)