Love this. There's no reason you can't host the write-up for your github projects / gems on your own domain, and make a much prettier and more intuitive documentation for your code than what you can do with markdown and no pictures. As an example, look how nice VowsJS (http://vowsjs.org/) does this. It makes me excited to clone their module and use it in my project. More people should be doing this!