andrel wrote:
> Look at it as if it is a program. The conclusions are the main routine.

That's what always killed me about mathematical proofs. They always 
start with all the details, and finally tell you why you care. :-)

I would clarify by saying the document should also *start* with the 
conclusion, because people are going to be trying to recreate the 
structure in their head as they read.

That's what is killing me about reading the Erlang documentation: there 
are all sorts of cross-references, and no obvious place to start 
reading.  I wouldn't be surprised if there are circular references 
throughout, either.

-- 
   Darren New / San Diego, CA, USA (PST)
     "That's pretty. Where's that?"
          "It's the Age of Channelwood."
     "We should go there on vacation some time."

Post a reply to this message