[racket] "lab notebook on learning process" (was: Re: Macros baffle me)

From: Hendrik Boom (hendrik at topoi.pooq.com)
Date: Mon May 5 21:59:49 EDT 2014

On Mon, May 05, 2014 at 11:58:17AM -0400, Sean Kanaley wrote:

> So technically it was my fault,
> but the documentation could benefit from some kind of "WARNING!" section on
> each or at least especially dangerous pages for such pitfalls.  Imagine if
> your car explodes if you have the break depressed while turning the AC
> dial.  Probably don't want that info on page 87 subsection a.1.c.  But
> since there's no way to anticipate all potential user bugs, it's not really
> the fault of the documentation writers either.  So who/what is at fault?

A better question that 'who is at fault' would be 'what can be done to 
alleviate the problem'. 

I would make it less of an emotional issue.

-- hendrik

Posted on the users mailing list.