0. No you’re not missing something. The issue has come up in a recent internal discussion. 1. The intention is that docs are primarily for Racket programmers who wish to use teachpacks in ordinary Racket programs though within reach for beginners (as in, “ignore some of the things you don’t understand and focus on the example.”) 2. In my courses, I suggest to read the words in the docs for functions, to read the examples, and ignore other things.
We will have to discuss internally how to have both kinds of documentation. No promises. — Matthias > On Nov 28, 2015, at 10:00 PM, Paolo Giarrusso <p.giarru...@gmail.com> wrote: > > While pointing students at teachpacks for HtDP/2e, one of our tutors > correctly pointed out that they're not documented using HtDP signatures, but > using standard Racket contracts. For instance, in big-bang's docs: > >> (to-draw render-expr) >> render-expr: (-> WorldState scene?) > > http://docs.racket-lang.org/teachpack/2htdpuniverse.html?q=posn#%28form._world._%28%28lib._2htdp%2Funiverse..rkt%29._big-bang%29%29 > > Instead, the beginner language seems to use a mixture, alternating between > "class" `number` and predicate `boolean?`: > > http://docs.racket-lang.org/htdp-langs/beginner.html > > And in fact, `number` is the style of HtDP/1e, while HtDP/2e uses `Number`. > > The differences aren't huge, but I'd guess that sometimes they're noticeable > or problematic for beginners. > > 0. Am I mistaking something? > 1. Is this intended or are changes planned? > 2. How do you deal with this in your courses? Do you teach both signature > styles? Will this not confuse students? > > Cheers, > Paolo > > -- > You received this message because you are subscribed to the Google Groups > "Racket Users" group. > To unsubscribe from this group and stop receiving emails from it, send an > email to racket-users+unsubscr...@googlegroups.com. > For more options, visit https://groups.google.com/d/optout. -- You received this message because you are subscribed to the Google Groups "Racket Users" group. To unsubscribe from this group and stop receiving emails from it, send an email to racket-users+unsubscr...@googlegroups.com. For more options, visit https://groups.google.com/d/optout.
