[plt-scheme] Re: how do you include documentation with a teachpack or planet collection?
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).