Escolar Documentos
Profissional Documentos
Cultura Documentos
for
Technical Writing
Vinod K. Banthia
M.D.Deshpande
VKB
M.S.Ramaiah School of Advanced Studies
General Issues
Why a lecture about writing?
Surely, any literate can write. Why talk about Writing?
Any body can sing. But, can we get an audience?
Writing is for communication? Can we get readers?
Writing is a SKILL.
Good writing is an ART. More so Technical Writing.
There may be those who are born or gifted writers.
Others have to LEARN and PRACTICE.
VKB
M.S.Ramaiah School of Advanced Studies
Contents
Introduction
General Issues
Basic Requirements
Elements of Technical Writing
Writing a Project Report
Selecting a Project Composing the Title - Writing the Introduction Body of
the Report Problem Methodology and Tools Collecting the Results
Presentation of the Results Conclusions and Recommendations Abstract
Appendix
VKB
M.S.Ramaiah School of Advanced Studies
Scope:
Introduction
Presentation of broad guidelines on writing a project report.
VKB
M.S.Ramaiah School of Advanced Studies
"Practice
Publilius Syrus,
Syrian-born Roman author, c. 100 BC
VKB
M.S.Ramaiah School of Advanced Studies
Purpose:
Provide an opportunity to develop the writing skills.
Assignment
Exam
Project Report
VKB
M.S.Ramaiah School of Advanced Studies
Basic Requirements
Technical writing is a specialized field that requires
Personal Discipline
Organization Skill
Skill in Writing Clearly and Concisely
Understanding of Technical Products and Processes
Knowledge of numerous software tools
Good Vs Bad writing: This is subjective. No one is perfect.
VKB
M.S.Ramaiah School of Advanced Studies
Organisation
What are you writing about?
What do you plan to achieve in what you are writing?
I
Ideas
II
Flow
III
IV
Hierarchy
Refinement
VKB
M.S.Ramaiah School of Advanced Studies
Audience
Who is going to read the report?
What is the level of their current knowledge?
How much information is needed?
What background information to include?
Why is the reader reading the report?
Is the document supposed to inform or convince?
How much time does the reader have to read it?
VKB
M.S.Ramaiah School of Advanced Studies
10
11
..
Keywords: vortex motion; viscous decay; closed streamlines; cavity; toroidal surface
___________________________________________________________________________________________
1.Introduction
Although many studies exist of both inviscid and viscous free vortices, not many exist
of confined three-dimensional vortex motions, despite these being of fundamental and
practical interest. Confined flows, of course, have special complications brought about
by, for instance, the presence of corner or secondary vortices and separation and
reattachment points; moreover if the initial state is turbulent, transition to the laminar
state will occur with the decay of the vortex motion. It is clear that with all these
complexity one will
(The modern style is more compact, terse, to the point and less personal.)
VKB
M.S.Ramaiah School of Advanced Studies
12
13
Conciseness
Fiction
Technical
Information
Information
Emotion
Mood
Image
Word Play
Be Concise
BUT
Be Complete
VKB
M.S.Ramaiah School of Advanced Studies
14
Basic Requirements
Good Vs Bad writing: This is subjective. No one is perfect.
writing should meet minimum acceptable standard.
Avoid spelling errors (like bad notes in music)
Load and boundary conditions applied on the model is shown in
the figure bellow
The following steps are used in preparing FE model for thermal
analysisodal analysis
Use built-in Dictionary but dont rely wholly on it.
Following procedure followed for performing model analysis
There are too birds on the tree
Select appropriate version of English for spell checking
15
16
VKB
M.S.Ramaiah School of Advanced Studies
17
VKB
M.S.Ramaiah School of Advanced Studies
18
VKB
M.S.Ramaiah School of Advanced Studies
19
VKB
M.S.Ramaiah School of Advanced Studies
20
VKB
M.S.Ramaiah School of Advanced Studies
21
VKB
M.S.Ramaiah School of Advanced Studies
22
Define the symbol the very first time it is used. Use symbols consistently through out
the presentation. Ex: frequency is represented by the symbol f ( or ). Note the
difference between the angular frequency (radians per sec) and the linear frequency
f (Hz).
Use appropriate symbols for Scalars, Vectors, Matrices. Define the convention.
Transforms are generally shown in Upper case. F(), T(s), H(z).
Take care of sub-scripts and super-scripts. Use parenthesis to properly group the
terms. Numerator and denominator are to be properly separated.
VKB
M.S.Ramaiah School of Advanced Studies
23
Alphabet
Frequency
20%
air
18%
clear-water
12%
Sea-water
6%
oil
Velocity
VKB
M.S.Ramaiah School of Advanced Studies
24
VKB
M.S.Ramaiah School of Advanced Studies
25
VKB
M.S.Ramaiah School of Advanced Studies
26
VKB
M.S.Ramaiah School of Advanced Studies
27
VKB
M.S.Ramaiah School of Advanced Studies
28
VKB
M.S.Ramaiah School of Advanced Studies
29
30
Selecting a Project
Dont be too ambitious - selecting a big project that cant be handled within the
available time reflects badly (give examples) - Dont select a trivial project either
Discuss with various persons
What Employers look for in a project? Important Points to remember:
DEPTH QUALITY COMPLETENESS KNOWLEDGE ACQUIRED
SKILLS ACQUIRED PRESENTATION SKILLS (Oral and Written)
Depth: Thoroughly familiar with all the terms / concepts /formulae used.
Quality: Work must show the ability to solve a problem know the difference
between reality and model: Resistor Vs Resistance? (More about it later).
Completeness: Making a big claim in the Title of the project, but within the report
stating that due to lack of time only a part could be done - not a good practice.
Knowledge/Skills Acquired: Employers are going to test the knowledge relating to the
problem area You must become an expert in the chosen problem area (sub-area)
be able to teach /guide / lecture -
VKB
M.S.Ramaiah School of Advanced Studies
31
VKB
M.S.Ramaiah School of Advanced Studies
32
Abstract
VKB
M.S.Ramaiah School of Advanced Studies
33
tic
con
cre
t
fro
m
ac
pr
or
al
Thoug
refere ht of or st
a te
nce to
a spec d without
ific in
stance
Ap
art
ie
pl
to
ap
cult
i
f
f
i
D
stand
r
e
d
un
t
No
ABSTRACT
VKB
M.S.Ramaiah School of Advanced Studies
34
ABSTRACT
Quickly and accurately identify basic contents of the paper
Check if the related research is of interest
To attract the interest and curiosity of the non-specialist reader
Quickly acquaint the reader of current research
Generate interest and curiosity of the non-specialist reader
Entice potential readers into obtaining a copy of the full paper
To be remembered long after the paper has been read
Because on-line search databases typically contain only abstracts
Concise
Complete
VKB
M.S.Ramaiah School of Advanced Studies
35
Descriptive
ABSTRACT
Informative
Communicate specific information
from the report, article, or paper
Include the purpose, methods, and
scope of the report, article, or paper
Provide the report, article, or
paper's results, conclusions, and
recommendations
Are short -- from a paragraph to a
page or two, depending upon the
length of the original work being
abstracted. Usually informative
abstracts are 10% or less of the
length of the original piece
Allow readers to decide whether
they want to read the report, article,
or paper.
VKB
M.S.Ramaiah School of Advanced Studies
36
ABSTRACT
The Effect of Injection Pumps on Cold Starting of Diesel Engines.
Descriptive Abstract:
Results are presented of a series of cold-room tests on a diesel engine to determine the
effect on starting time of (1) fuel quantity delivered at cranking speed, and (2) type of
fuel injection pump used. The tests were made at a temperature of -100 Fahrenheit;
engine and accessories were chilled to -100 F at least 8 hrs before the experiment
began.
Informative Abstract:
Cold weather tests were made to determine the effect of cold starting of the quantity
of fuel injected at cranking speed for two types of injection pump. The diesel engine
of the energy cell-Lanova type that was used had 3.75bore, 5 stroke and 331 cubic
inch displacement. The cold room was maintained at -100 F ; engine, batteries, fuel
and lubricating oils, and all equipment were chilled to -100 F for at least 8 hours
before the engine was started. .
VKB
M.S.Ramaiah School of Advanced Studies
37
ABSTRACT
Contents:
Problem Statement
Methodology
Results
Conclusions
Complete
Concise
Clear
Cohesive
VKB
M.S.Ramaiah School of Advanced Studies
38
ABSTRACT
Structure:
Purpose of the study/paper:
Techniques/Approaches used:
Experimental
Analysis
Sources
.
Results/Collected Data/Observations:Experimental
Theoretical
New Findings/Contradictions
Accuracy/Reliability
Conclusions:
VKB
M.S.Ramaiah School of Advanced Studies
39
ABSTRACT
Hints:
Reread the article, paper, or report with the goal of abstracting in mind
Look at main parts of each section of the paper
Use the headings, outline heads, and table of contents as a guide
Write first draft (No Cheating)
Don't merely copy key sentences
Summarize information in a new way
Revise the rough draft
Improve Organization
Improve Transitions
Drop Unnecessary Information
Add Important Information
Eliminate wordiness
Check spelling, grammar and punctuation
VKB
M.S.Ramaiah School of Advanced Studies
40
ABSTRACT
Hints:
Clear and concise results/conclusions but adequate description of project
Proper word choice for conciseness
Use Key words
Be Specific (-10 F versus very low temperature)
Drop unnecessary information
this paper will look at.... , This Paper, is described/reported
It is believed that.,
Do not repeat or rephrase the title
Do not refer to things not in the paper
Assume good Technical vocabulary -- Avoid highly specialized words/abbs.
Past tense to describe the work already done, Present tense for existing facts
Use primarily active voice. Use passive voice if it reduces word count
VKB
M.S.Ramaiah School of Advanced Studies
41
Introduction
VKB
M.S.Ramaiah School of Advanced Studies
42
VKB
M.S.Ramaiah School of Advanced Studies
43
VKB
M.S.Ramaiah School of Advanced Studies
44
VKB
M.S.Ramaiah School of Advanced Studies
45
VKB
M.S.Ramaiah School of Advanced Studies
46
VKB
M.S.Ramaiah School of Advanced Studies
47
VKB
M.S.Ramaiah School of Advanced Studies
48
Problem
Problem is broadly specified by the Programme Manager.
But narrow down the problem.
Ex: where do you live? In solar system, on earth, in India, in Karnataka,
Subject > Area > Topic > Problem (Area )> Your Problem (sub-area)
Electronics > Digital Signal Processing > Image Processing > Face Recognition
Face Recognition: Is it identification or Verification?
Technique: What Features are used? What is the Classification strategy?
Situation: Input Image: Passport photographs, web camera, movie clippings etc.
Setting-up performance criteria is a part of the problem statement Is it to improve
the speed or accuracy? Is it hardware implementation or simulation study etc?
What is the size of database?
Relevance: Application.Why have you selected this problem? What are the
engineering challenges that are addressed in the problem?
Literature Survey: How similar problems have been solved? Put your work in the
contemporary context.
VKB
M.S.Ramaiah School of Advanced Studies
49
Problem #2
State the Problem (PHYSICS/REALITY). Start from the broad area and narrow down
to the specifics.
Engineering design is a trade-off between Performance and Cost.
What are the performance criteria? What are the goals? What are the costs involved?
NARROW DOWN.
State the various approaches available to solve the problem. Literature Survey.
Justify the particular approach you are going to use.
Give both the theoretical basis and the basis for selecting particular tools.
If you are good at coding (programming), nothing like writing your own code.
VKB
M.S.Ramaiah School of Advanced Studies
50
51
VKB
M.S.Ramaiah School of Advanced Studies
52
Presentation of Results
How to present the results? Prepare a menu card. Serve item by item.
The presentation must cover the following:
1 Tools or equipments used. Model No., Version No. , Manufacturer or Developer.
Actual set-up. Additional details can be given in Appendix.
2 Testing of the tool on a smaller scale before the actual presentation of the results or
Calibration of the instruments used to make the measurements.
3 Testing on data where results are predictable or replication - for validation.
4 Scope of the experiments regarding the range of the input parameters and what are
the output parameters that are being measured.
5 Present one experiment at a time with a clear objective for the experiment. Present
the results and discuss the main findings. Use Tables, Graphs etc for proper
illustration. Use proper scale and legend for the Graphs.
6 Show the link between one experiment and another. Present the results in a graded
manner.
VKB
M.S.Ramaiah School of Advanced Studies
53
VKB
M.S.Ramaiah School of Advanced Studies
54
Appendix
Explanatory material that would interfere with the logical continuity.
Avoids congestion of the report. Pertinent but too detailed to be seen
later if required
Not directly contributing to the report not that of the author Supporting material not critical and may be of interest only to a few
readers.
----------Supplementary calculations; detailed derivations; charts, maps, graphs
as additional information; detailed experimental results; description
of equipment; description of software tool;
----------Each item has to have an identifying tag and a title.
VKB
M.S.Ramaiah School of Advanced Studies
55
VKB
M.S.Ramaiah School of Advanced Studies
56
General Hints
Whole to Part: Going from broad area or overview into details is a better
approach. Master Plan to fine details. (Four walls and a roof; later interiors)
Do the work in several rounds. First round: Assume that you are preparing one
page assignment to be submitted within one day. Propose a tentative title, write a
crude report. Second round add some more details etc.
Look for information sources. Prioritize: Text Books, Journals (review articles)
and Web browsing. Write down the reference immediately. Be FOCUSSED while
browsing. Dont go too deep during the first round of reading. Dont try to
understand all aspects. Just establish links between the problem and the sources.
Several rounds of light reading is better than one round of deep reading.
Categorize the reading material: Definition, Concept, Illustration, Formula,
Details, Case Study etc. Xerox parts and build-up a crude report. Then write it in
your own words.
VKB
M.S.Ramaiah School of Advanced Studies
57
Referencing
All statements, opinions, conclusions etc. taken from another
writers work should be cited, whether the work is directly quoted,
paraphrased or summarized.
A restatement of a
text or passage in
another form or
other words, often
to clarify meaning.
Harvard Reference
Oxford Reference
Presenting the
substance in a
condensed
form; concise
APA Reference
VKB
M.S.Ramaiah School of Advanced Studies
58
Harvard Reference
In the Harvard System cited publications are referred to in the text by
giving the authors surname and the year of publication and are listed
in a bibliography at the end of the text.
In the book by Ln1 and Ln2 / Ln1 et al. (1995) .....
There are indications that passive smoking is potentially threatening to
the health.......... ( Ln1 and Ln2, Yr; Ln, Yr)
Ln1 and Ln2 (Yr) state that "networking is no longer solely
within the male domain . . ."(p.XX).
Ln1 and Ln2 (Yr) in discussing staff development state that:
"Development is infectious, and staff who previously have recoiled
from undertaking a degree or conversion course have been encouraged
by the success of others"(p.XX).
VKB
M.S.Ramaiah School of Advanced Studies
59
Harvard Reference
In the Harvard System, the references are listed in
alphabetical order of authors names.
Book
Ln,Fn / Ln,Fn and Ln,Fn /Ln,Fn et al. (Yr) Title of the book, Edition,
Place of publication, Publisher.
Edited Book
Ln,Fn / Ln,Fn and Ln,Fn /Ln,Fn et al. (eds) (Yr) Title of the book,
Edition, Place of publication, Publisher.
Chapter in a Book
Ln, Fn (Yr) Chapter Title. In: Fi. Ln et al. (eds) Title of the book.
Place of publication, Publisher. p. xx- yy.
Article in a journal
Ln, Fi. (Yr) Article Title. Journal Title, V(N), XX-YY.
VKB
M.S.Ramaiah School of Advanced Studies
60
Harvard Reference
From published conference proceedings
Ln1, Fi. et al (Yr) Article Title: Proceedings of the Conference held at
the Location. Place
From published conference proceedings
Ln, Fn. (1998) Article Title. In: Ln, Fi. et al. Proceeding Title:
Conference held at the Conference Location. Place. p.XX - YY.
Dissertation
Ln, Fn (1995) Dissertation title. Unpublished Degree dissertation,
University.
VKB
M.S.Ramaiah School of Advanced Studies
61
Harvard Reference
http://home.ched.coventry.ac.uk/caw/harvard/index.htm
*
Oxford System
Sequential:
In this system each citation is given a unique number in the order in
which it appears in the text, either in brackets or superscripted.
VKB
M.S.Ramaiah School of Advanced Studies
62
Electronic References
WWW
Ln, Fi. Mi. (Pub. Date). Title. Site. URL (Date Accessed).
E-mail
Ln, Fi. (Msg. date) subject Line Discussion or Newsgroup list. List
address (Date Accessed).
Online Reference Source
Ln, Fi. Title. (1993). In Title of complete work.
Online resource. Path to the source (Date Accessed).
Electronic
Publication/Database
Ln, Fi. Title. (1993). Title of complete work Version No.
Name of the DB, Online resource. Access Info. (Date Accessed).
VKB
M.S.Ramaiah School of Advanced Studies
63
Resources
http://dictionary.oed.com/entrance.dtl
http://www.m-w.com/netdict.htm
http://www.bartleby.com/141/
VKB
M.S.Ramaiah School of Advanced Studies
64
VKB
M.S.Ramaiah School of Advanced Studies
65
Philosophy
Honesty is the best policy.
You cannot write a good report / paper unless you have something to say.
First decide what is that you want to say. Then say it boldly, clearly and briefly.
Technical writing is a boring job. Doing an experiment or computation or
observing the sky is more exciting. (They involve new tasks!) But technical
reporting is an equally important job. Hence it has to be done properly. It does
not necessarily mean we have to spend more time.
Poor technical writing makes one suspect about the care taken in your
technical work itself.
VKB
M.S.Ramaiah School of Advanced Studies
66
67
EXAMPLES
From: The Origin of the Species by Charles Darwin (1859)
VKB
M.S.Ramaiah School of Advanced Studies
68
EXAMPLES
From: The Origin of the Species by Charles Darwin (1859)
Page 477.
Although I am fully convinced of the truth of the views
given in this volume . I by no means expect to convince
experienced naturalists whose minds are stocked with multiple of
facts all viewed, during a long course of years, from a point of view
directly opposite of mine. It is easy to hide our ignorance under such
expressions as the plan of creation unity of design, &c., and to
think that we give an explanation when we only re-state a fact.
Feel the pressure and pain under which he is writing. Also notice
how he has used the word stocked. (Is it complimentary?) How
clearly he points out the mistake of other naturalists.
VKB
M.S.Ramaiah School of Advanced Studies
69
EXAMPLES
CURRENT SCIENCE
Volume 88
10 April 2005
______________________________________________________________________________________________________________________________________________________
Abstract: Recent cosmological observations suggest that nearly seventy per cent of
the energy density in the universe is unclustered and has negative pressure. Several
conceptual issues related to the modelling of this component (dark energy), which is
driving an accelerated expansion of the universe, are reviewed with special emphasis
on the cosmological constant as the possible choice for the dark energy.
VKB
M.S.Ramaiah School of Advanced Studies
70
EXAMPLES
CURRENT SCIENCE
Volume 88
10 May 2005
______________________________________________________________________________________________________________________________________________________
VKB
M.S.Ramaiah School of Advanced Studies
71
EXAMPLES
CURRENT SCIENCE
Volume 88
10 April 2005
______________________________________________________________________________________________________________________________________________________
VKB
M.S.Ramaiah School of Advanced Studies
72
EXAMPLES
CURRENT SCIENCE
________________________________________________________________________________________________________________________________________________________________
VKB
M.S.Ramaiah School of Advanced Studies
73
Best Wishes
74
Happy Writing
Happy Reading
VKB
M.S.Ramaiah School of Advanced Studies
75