What you are describing as good is what literate programming is about, and what you say is bad, is exactly what literate programming tries to a avoid.