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
____________________
  Racket Users list:
  http://lists.racket-lang.org/users

Reply via email to