Although I use comments in a conventional way ... as much as possible, comments answers the questions of Why, Who and When. I leave the How to the actual code.
An actual example is: NB. --------------------------------------------------------- NB. [email protected] 2008 10 22 16 27 45.749 NB. Issue No: ##### as requested by Adel NB. Changing code so that if a material is not defined in NB. the SDUV UV Summary, it will use the AD BOM Consumption I found out that most of the time, the question of Why, Who and When is asked more frequently and with more force over the How. It also allows me to get a glimpse of the current mindset during the time of change and better understanding of the verb/module/function as a whole. r/Alex ________________________________________ From: [email protected] [[email protected]] On Behalf Of Joey K Tuttle [[email protected]] Sent: Tuesday, September 22, 2009 2:31 AM To: Chat forum Subject: [Jchat] Worthwhile advice Even though the opposite might be claimed by most "conventional software developers" -- I think j offers a good support structure for the following idea - http://programmer.97things.oreilly.com/wiki/index.php/Only_the_Code_Tells_the_Truth ---------------------------------------------------------------------- For information about J forums see http://www.jsoftware.com/forums.htm ---------------------------------------------------------------------- For information about J forums see http://www.jsoftware.com/forums.htm
