On Nov 18, 2013, at 3:15 PM, Norman Ramsey <[email protected]> wrote:
>> This is easily doable with a teachpack: >> >> 1. how to create a teachpack >> http://docs.racket-lang.org/htdp/index.html?q=teachpack >> >> 2. the key is to document the (a) structure type definition and (b) the >> data definition you export. > > Any recommendations for delivering the documentation? I'm thinking > that a "here string" in the source code might be a good bet, but I'm > not sure what tool support might be available. > I'd use the kind of comments that they are supposed to write, and as my example shows, I'd place them at the head of the teachpack, and I'd expect them to read that much. We do so routinely in our labs. ____________________ Racket Users list: http://lists.racket-lang.org/users
