Your call; it's just a function of the relative weight of meta-explanation over code. Over some critical ratio I think it's better to have a narrative page than an example script. I'm not sure what that ratio is, though :)