Include commentary with samples

[alerque]

I think to make many of the samples really useful it would be beneficial to have some way of adding notes to samples. I thought of doing this with comments inline with the sources, but this seems like a messy way to go in the long run.

I think some sort of markdown file to go with each sample would be more useful in the long run.