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

Re: Readability suggestions

• To: mathgroup at smc.vnet.net
• Subject: [mg3021] Re: [mg2977] Readability suggestions
• From: Allan Hayes <hay at haystack.demon.co.uk>
• Date: Wed, 24 Jan 1996 03:32:45 -0500

"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



==== [MESSAGE SEPARATOR] ====