[Date Index] [Thread Index] [Author Index]

Re: Readability suggestions

• Subject: [mg3021] Re: [mg2977] Readability suggestions
• From: hay at haystack.demon.co.uk (Allan Hayes)
• Date: 24 Jan 1996 15:34:55 -0600
• Approved: usenet@wri.com
• Distribution: local
• Newsgroups: wri.mathgroup
• Organization: Wolfram Research, Inc.
• Sender: mj at wri.com

"Daryl Reece" <reece_d%a1.clust.CLUST.umc at engult.lxe.com>
In [mg2977] Readability suggestions
asks  "Does anyone have suggestion for making MMA notebooks
readable to non MMA literate people."

Daryl,
Two of the things that I try to bear in mind, even for MMA literate  
people, are

1. Be succinct.
2. It is not necessary for the reader to see every bit of code:if  
it is not necessary then hide it in a closed group or a closed cell  
or put it in an appendix or package -- it's there if the reader  
wants to see it.

Allan Hayes,
hay at haystack.demon.co.uk