Re: How to write a "proper" math document

*To*: mathgroup at smc.vnet.net*Subject*: [mg119926] Re: How to write a "proper" math document*From*: "McHale, Paul" <Paul.McHale at excelitas.com>*Date*: Thu, 30 Jun 2011 06:29:45 -0400 (EDT)*References*: <201106281156.HAA21514@smc.vnet.net>

>>A possible alternative is the Presentations package by David Park. Get in >>touch with the author at djmpark at comcast.net or check for more info at >>http://home.comcast.net/ Thanks for the great idea. After reading this post and the post from David, I will definitely buy this package. >>Presentations is (IMHO) a must for Mathematica graphics development and >>technical documents creation. It will save you plenty of time, ... and you >>know that time is money. The problem is that only those who own a license of >>Mathematica could read your "live-documents" so created, except if you >>distribute them through Mathematica Player. See details for MathPlayer at >>http://reference.wolfram.com/mathematica/howto/DeployANotebookForPlayer.html Distribution through Mathematica Player is problematic because the contents could be ITAR restricted. As you know: if you don't know, it is restricted. I wish there was a way to do this for ourselves. Must be a security is sue with releasing this capability into the wild. Paul McHale | Electrical Engineer, Energetics Systems | Excelitas Technologies Corp. Phone: +1 937.865.3004 | Fax: +1 937.865.5170 | Mobile: +1 937.371.2828 1100 Vanguard Blvd, Miamisburg, Ohio 45342-0312 USA Paul.McHale at Excelitas.com www.excelitas.com Please consider the environment before printing this e-mail. This email message and any attachments are confidential and proprietary to Excelitas Technologies Corp. If you are not the intended recipient of this message, please inform the sender by replying to this email or sending a message to the sender and destroy the message and any attachments. Thank you -----Original Message----- From: E. Martin-Serrano [mailto:eMartinSerrano at telefonica.net] Sent: Wednesday, June 29, 2011 5:30 AM To: mathgroup at smc.vnet.net Subject: [mg119926] Re: How to write a "proper" math document Paul, A possible alternative is the Presentations package by David Park. Get in touch with the author at djmpark at comcast.net or check for more info at http://home.comcast.net/ Presentations is (IMHO) a must for Mathematica graphics development and technical documents creation. It will save you plenty of time, ... and you know that time is money. The problem is that only those who own a license of Mathematica could read your "live-documents" so created, except if you distribute them through Mathematica Player. See details for MathPlayer at http://reference.wolfram.com/mathematica/howto/DeployANotebookForPlayer.html Cheers E. martin-Serrano -----Mensaje original----- De: McHale, Paul [mailto:Paul.McHale at excelitas.com] Enviado el: martes, 28 de junio de 2011 13:56 Para: mathgroup at smc.vnet.net Asunto: How to write a "proper" math document Hi, I am an engineer who lacks the audacity to claim any special awareness in math, but do find what skills I have very useful. One of the tasks engineers have is to leave a trail of bread crumbs for others to follow. This document ends up being design calculations (minimally) and a process of discovery (ideally). I have found myself and other engineers often understand what we are doing, but are far worse at communicating it. I agree this indicates a gap in understanding to some degree. I think it is also true that we can think of Moby Dick but don't have the proper writing skills to convey it as a novel. The result is a mixture of ineffective writing styles to document work. Does anyone have a set of rules or a style document for how to write a document that will be mathematically oriented? I have found some information. A common set of tasks I do include: Document(minimal) 1. Highlight original datasheet pdf using PDF XChange (free) 2. Use screen hunter to capture relevant part of PDF and past into notebook 3. Use above information to as input data to perform calculations 4. Mix calculations with explanation of what and why Discovery(ideal) 1. Describe existing solution or foundation from which we are going to extrapolate 2. Explain (charts, data, verbage) why this is insufficient 3. Show what we are changing to achieve better results Maybe the discovery could almost be called a white paper. What I am looking for is rules such as when to refer to an equation by number (can Mathematica do this?) or when we should just "in line" the equation within a sentence. Any such rules would be appreciated. Once document I have found is: http://ems.calumet.purdue.edu/mcss/kevinlee/mathwriting/writingman.pdf While very good, it is not mathematica centric. I.e. Is there way to quickly open and close cells since programming cells reduce document readability for the Mathematica un-challenged :). I'm sure there is much more to the Mathematica front end than what I am using. Paul McHale | Electrical Engineer, Energetics Systems | Excelitas Technologies Corp. Phone: +1 937.865.3004 | Fax: +1 937.865.5170 | Mobile: +1 937.371.2828 1100 Vanguard Blvd, Miamisburg, Ohio 45342-0312 USA Paul.McHale at Excelitas.com www.excelitas.com Please consider the environment before printing this e-mail. This email message and any attachments are confidential and proprietary to Excelitas Technologies Corp. If you are not the intended recipient of this message, please inform the sender by replying to this email or sending a message to the sender and destroy the message and any attachments. Thank you

**References**:**How to write a "proper" math document***From:*"McHale, Paul" <Paul.McHale@excelitas.com>