Talk:Ringenberg Examples-as-Help

Interactive Communication Cluster: Wiki Page Reviews and Discussion

Date:March 5, 2007
Reviewer: Kirsten Butcher
Review:
Abstract: The abstract is succinct and clear, but there are a couple things that may help the reader understand the manipulation and its important.
First, it is easy to trip up on the term "completely justified example." So, it was very helpful that you included a glossary entry for the term. But I still have some confusion. To what does "completely" refer to? Is it the number of steps shown, the inclusion of the explanation, or both? The explanations/rationale for the steps don't seem very complete. So I assume the hints are "completely justified" in the sense that they give you all the steps for the problem as well as a little guidance on those steps. But it may help drive the point home to compare the difference between these hints and the standard hint sequences in the glossary entry. Also, adding a very brief description of each condition to the abstract text would help the reader understand the relevant comparisons (as is, the reader must first follow glossary links to develop an understanding of each condition separately, then must infer the relevant contrasts).