[racket-dev] New error messages for *SL
If it is a click away and if the idea is that students got to B because they went thru A?
I admit that there are instructors who use only ISL+ or ASL. But should we accommodate the special ones or the ones that use the language hierarchy as intended?
On Jul 6, 2011, at 5:51 PM, Jay McCarthy wrote:
> If you read the documentation as a textbook when you start
> programming, I can see wanting to see something that says "cond is the
> same as before". But, if you read the documentation as a reference
> when you have a problem it is frustrating to chase through a few links
> to get the "real" documentation.
>
> Is that the idea, Guillaume?
>
> Jay
>
> 2011/7/6 Matthias Felleisen <matthias at ccs.neu.edu>:
>>
>>
>> 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 <mflatt at 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
>>
>
>
>
> --
> Jay McCarthy <jay at cs.byu.edu>
> Assistant Professor / Brigham Young University
> http://faculty.cs.byu.edu/~jay
>
> "The glory of God is Intelligence" - D&C 93