[plt-scheme] Re: how do you include documentation with a teachpack or planet collection?

From: Stephen Bloch (sbloch at adelphi.edu)
Date: Tue Dec 18 09:49:39 EST 2007

At 8:31 AM -0400 8/26/07, I wrote:
>Here's my goal: create a file (presumably a .plt) that my 
>English-major students can install, in one easy step (preferably 
>without needing to specify WHERE to install it; it should know by 
>itself), after which
>(a) the "tiles.ss" teachpack will appear on the list of available 
>teachpacks in the teaching languages (I don't care whether it's on 
>the left side or the right), and
>(b) when they add that teachpack, they get a properly compiled 
>version (presumably .zo), and
>(c) when they add that teachpack and type the name of one of its 
>functions into the Help Desk, they'll see the documentation.  (If 
>they could also see the documentation WITHOUT adding the teachpack 
>first, that would be nice but not required.)
>Is that possible?

I later added:
>  > The rule of thumb should be "would you give this step to a bunch of
>>  non-CS-majors in their first week of their first programming class?"
>>  I can expect more sophistication from the computing-center people who
>>  install stuff on the lab machines, but my students (and those of my
>>  textbook testers) will need to be able to install stuff on their home
>>  machines.  Most of them wouldn't know a "command line" if it bit
>>  them, so I'd prefer to avoid that (and the associated
>>  platform-dependence).
>>
>>  Switching to a non-HtDP language in DrScheme, typing one obscure
>>  command, and then switching back to "Beginner" doesn't sound too bad,
>>  if they don't have to type that obscure command ever again.
>>  "File->Install .plt file->[type in a URL]" would be even better, but
>>  I'll take what I can get.

At 7:08 AM -0500 8/27/07, Robby Findler wrote:
>Yes, Matthew anticipated this reply and Jacob is working on something
>suitable for such students so they can install planet packages as
>easily as they can install anything. (Roughly: clicking on a link,
>maybe plus double clicking something on their desktop, depending on
>the os).
>
>This should be hopefully better than the menu.

Any progress on this yet?  I'd like to have something my students can 
use for spring semester (which starts a month from now).



Posted on the users mailing list.