Yesterday my supervisor sent me a link to an article in the Washington Post. This morning I read it and these are the parts I think can be related to both review requests (Mike Conley’s topic) and literate programming:
The mainspring of comprehension is prior knowledge—the stuff readers already know that enables them to create understanding as they read.
Prior knowledge is vital to comprehension because writers omit information.
A writer who doesn’t assume some prior knowledge on the part of her readers will write very boring prose.
What happens if the reader doesn’t have the prior knowledge the writer assumed she had? The reader will be confused and comprehension breaks down.