Merge pull request #243 from graphitefriction/1-5-docs

adds source code block content
fixes #244 callout example syntax
Merge pull request #245 from graphitefriction/callouts

fixes #244 callout example syntax
copyedits
Merge pull request #246 from graphitefriction/callouts

copyedits
update the section about working with complex URLs, add id