Javascript comments

gistfile1.js

function flash(id) {
    // Fades the colored panel into 70% opacity on top of an image stored in
    // the value stored in ".img-holder img". This has the effect of a square
    // fading into a tinted photograph.
    ...
}