if we're super against adding the contents (or a an abridged version) of this gist, i would rather this be a separate file linked to so that the documentation isn't hindered by being offline.