Why not using the Jupyter Notebook ?

[DEKHTIARJonathan]

As u are building a "commented" python project, why don't you use tools such as Jupyter / IPython Notebooks. It would be, I think, totaly relevant for your use-case.

It is also fully rendered by Github, have a look to this tool, which will allow you to run IPython Notebook locally: https://www.continuum.io/downloads

It's fully supported and rendered by Github, here is a working example : https://github.com/DEKHTIARJonathan/neural-nets-are-weird/blob/master/notebooks/neural-nets-are-weird.ipynb

If you need any help, drop me a line ;)

[matbesancon]

thanks for the tip, I'll think about it for the next articles, but for this one, I wanted to separate my messy exploratory work (the Python files) from the (sort of) clean HTML articles. Plus I find notebooks to be a bit messy to version (each commit contains lots of modifications even though it was just reloading the same results).