documentation code block use gist embeds covert to markdown

[chrisdev]

The documentation code block use gist embeds for even two line snippets. This is bad!! These things needs to be converted to markdown or reStructured text blocks

• Create docs directory where the markdown will be placed
• Create an includes directory where the generated html will be stored
• Use the include directives in the templates
• Cache like crazy!!

A makefile to automate the process would be nice