SLIDE 1
If you have clarity in thoughts, there will be clarity in your words.
- -Subramanya Bharati, A Tamil poet
Technical writing M P Gururajan guru.mp@iitb.ac.in If you have - - PowerPoint PPT Presentation
Technical writing M P Gururajan guru.mp@iitb.ac.in If you have - - PowerPoint PPT Presentation
Technical writing M P Gururajan guru.mp@iitb.ac.in If you have clarity in thoughts, there will be clarity in your words. --Subramanya Bharati, A Tamil poet In fact, writing clarifies your thinking. Writing is not recording you don't just
SLIDE 2
SLIDE 3
In fact, writing clarifies your thinking. Writing is not recording — you don't just take a photocopy
- f what is in your head and put it on the page. It is
a far more creative and interactive process. As you write, you develop your thoughts. Writing is, in fact, rigorous thinking.
- -M Gardiner and H Kearns, Nature 475 , 129-
130 (2011)
SLIDE 4
More of second type (clarifies thought) than first type (clarity of thoughts come through), in my
- pinion!
Technical writing
SLIDE 5
Write everyday, at least five sentences: on your
- wn – without looking at any other document.
Rule No. 1
SLIDE 6
Write everyday, at least five sentences: on your
- wn – without looking at any other document.
Write what you did -- in your lab notebook!
Rule No. 1
SLIDE 7
Write everyday, at least five sentences: on your
- wn – without looking at any other document.
Write what you did -- in your lab notebook! Write what you think!
Rule No. 1
SLIDE 8
Write everyday, at least five sentences: on your
- wn – without looking at any other document.
Write what you did -- in your lab notebook! Write what you think! Write what you do not understand!
Rule No. 1
SLIDE 9
Write everyday, at least five sentences: on your
- wn – without looking at any other document.
Write what you did -- in your lab notebook! Write what you think! Write what you do not understand! Write something!
Rule No. 1
SLIDE 10
Read at least five good sentences everyday!
Rule No. 2
SLIDE 11
Read at least five good sentences everyday! To write well, you should have read good writing.
Rule No. 2
SLIDE 12
Read at least five good sentences everyday! To write well, you should have read good writing. How to identify good reading material in your area of interest? Backtracking method.
Rule No. 2
SLIDE 13
Content
What makes good writing, good?
SLIDE 14
Content Clarity
What makes good writing, good?
SLIDE 15
Content Clarity Style and voice
What makes good writing, good?
SLIDE 16
If we assume that the X-ray scattering of the 'unmodified' type observed by Prof. Compton corresponds to the normal or average state of the atoms and molecules, while the 'modified' scattering of altered wave-length corresponds to their fluctuations from that state,
Raman effect
SLIDE 17
it would follow that we should expect also in the case of ordinary light two types of scattering, one determined by the normal optical properties of the atoms or molecules, and another representing the effect of their fluctuations from their normal state.
Raman effect
SLIDE 18
It accordingly becomes necessary to test whether this is actually the case. The experiments we have made have confirmed this anticipation, and shown that in every case in which light is scattered by the molecules in dust- free liquids or gases, the diffuse radiation of the
- rdinary kind, having the same wave-length as
the incident beam, is accompanied by a modified scattered radiation of degraded frequency.
Raman effect
SLIDE 19
The new type of light scattering discovered by us naturally requires very powerful illumination for its observation
Raman effect
SLIDE 20
Indeed, it seems to me that the observations of “blackbody radiation,” photoluminescence, production of cathode rays by ultraviolet light, and other related phenomena associated with the emission or transformation of light appear more readily understood if one assumes that the energy of light is discontinuously distributed in space.
Einstein: photoelectric effect
SLIDE 21
According to the assumption considered here, in the propagation of a light ray emitted from a point source, the energy is not distributed continuously over ever-increasing volumes of space, but consists of a finite number of energy quanta localized at points of space that move without dividing, and can be absorbed or generated only as complete units.
Einstein: photoelectric effect
SLIDE 22
In this paper I wish to present the train of thought and cite the facts that led me onto this path, in the hope that the approach to be presented will prove of use to some researchers in their investigations.
Einstein: photoelectric effect
SLIDE 23
Not always necessary. See that last sentence from Einstein.
Personal pronouns and passive
SLIDE 24
Never take sentences from elsewhere – with or without modification -- and pass it off as your
- wn.
When you quote somebody, make sure that you quote verbatim and let the reader know that it is a quote
Rule No. 3
SLIDE 25
Technical writing: meant to communicate concepts, show your scholarship, and help
- thers take off from where you leave
Rule No. 4
SLIDE 26
Technical writing: meant to communicate concepts, show your scholarship, and help
- thers take off from where you leave
References are important. Spend the five to six hours needed for sprucing up the references every time you write your report
Rule No. 4
SLIDE 27
Top down and bottoms-up writing!
Some tricks of the trade
SLIDE 28
Top down and bottoms-up writing! Write the section titles, sub-section titles, sub- sub-section titles, paragraphs – a line for each; build on this
Some tricks of the trade
SLIDE 29
Top down and bottoms-up writing! Write the section titles, sub-section titles, sub- sub-section titles, paragraphs – a line for each; build on this Write everything that comes to your mind
- indiscriminately. Edit, move around passages
and modify – never delete till the end
Some tricks of the trade
SLIDE 30
Top down and bottoms-up writing! Write the section titles, sub-section titles, sub- sub-section titles, paragraphs – a line for each; build on this Write everything that comes to your mind
- indiscriminately. Edit, move around passages
and modify – never delete till the end I usually use the second approach
Some tricks of the trade
SLIDE 31
Write experimental details / simulation part first
Some tricks of the trade
i
SLIDE 32
Write experimental details / simulation part first Write results next
Some tricks of the trade
i
SLIDE 33
Write experimental details / simulation part first Write results next Write the conclusions
Some tricks of the trade
i
SLIDE 34
Write experimental details / simulation part first Write results next Write the conclusions Write the introduction after the conclusions: tune introduction depending on your conclusions
Some tricks of the trade
i
SLIDE 35
Write experimental details / simulation part first Write results next Write the conclusions Write the introduction after the conclusions: tune introduction depending on your conclusions Write the abstract last!
Some tricks of the trade
i
SLIDE 36
Tell a story!
Some tricks of the trade
SLIDE 37
Tell a story! Tell what is expected and why
Some tricks of the trade
SLIDE 38
Tell a story! Tell what is expected and why Tell what you get and what is its significance
Some tricks of the trade
SLIDE 39
Tell a story! Tell what is expected and why Tell what you get and what is its significance Go back to Raman and Krishnan's way of announcing their discovery or Einstein's way of setting his hypothesis / thesis out
Some tricks of the trade
SLIDE 40
Don' tell; show (Replace text by figures, plots, tables, ...)
Some tricks of the trade
SLIDE 41
Don' tell; show (Replace text by figures, plots, tables, ...) Be quantitative; prose without numbers sounds fluffy and without substance
Some tricks of the trade
SLIDE 42
Don' tell; show (Replace text by figures, plots, tables, ...) Be quantitative; prose without numbers sounds fluffy and without substance Careful with numbers: put error bars; know their limitations; do not report beyond the allowed accuracy
Some tricks of the trade
SLIDE 43
Know your audience: what you write in your annual progress seminar report is different from your conference proceedings paper is different from your journal paper is different from popular writing in a newspaper about your work
Some tricks of the trade
SLIDE 44
Abbreviations: first time in expanded form with abbreviation in brackets
Some norms for good writing
SLIDE 45
Abbreviations: first time in expanded form with abbreviation in brackets Equations: neatly labelled; every term should be explicitly explained
Some norms for good writing
SLIDE 46
Abbreviations: first time in expanded form with abbreviation in brackets Equations: neatly labelled; every term should be explicitly explained Figures: clean, with axes labeled, proper title
Some norms for good writing
SLIDE 47
Abbreviations: first time in expanded form with abbreviation in brackets Equations: neatly labelled; every term should be explicitly explained Figures: clean, with axes labeled, proper title Any claim – support with references to the literature
Some norms for good writing
SLIDE 48
Do not use informal words/expressions (OK, don't, can't, ...)
- r
informal spelling (density&temperature, ...) in technical writing
Some norms for good writing
SLIDE 49
Buy a good dictionary Subscribe to a good technical journal: wired, economist, resonance, ... Learn LaTeX / gnuplot / R/ ... Use lab note book extensively Learn to use a spell checker
Tools of the trade: be skilled
SLIDE 50