Why is it pedagogical to repeat information in the ISL documentation that the BSL documentation already presented?
-- Matthias On Jul 6, 2011, at 9:36 AM, Guillaume Marceau wrote: > On Wed, Jul 6, 2011 at 9:14 AM, Matthew Flatt <mfl...@cs.utah.edu> wrote: >> In the case of the HtDP languages, was the choice to duplicate all the >> text deliberate, or was it a side-effect of some other change? > > Yes, this was a deliberate move away from the no-duplication style > used in the professional documentation, for pedagogical reasons. > > At each language level, I gathered in a separate section called > "Common Syntax" the forms that that level has in common with the > previous level. The idea is to make it possible to get a quick sense > of of the commonality between the levels, while giving the students > confidence that documentation page they are looking at is > comprehensive. > _________________________________________________ > For list-related administrative tasks: > http://lists.racket-lang.org/listinfo/dev _________________________________________________ For list-related administrative tasks: http://lists.racket-lang.org/listinfo/dev
