I saw some nice notebooks where people made good efforts to include documentation along with the code. Some nicely formatted LaTeX. But that was the exception.
Still, I think they are a decent interface, even though they shouldn't replace a clean code-base.