29
31st March 2011 Technical writing -kpmdas 1 HOW TO WRITE PAPERS ? A brief note on TECHNICAL WRITING Prof K P Mohandas

How to write papers - A note on Technical Writing

Embed Size (px)

DESCRIPTION

A note on technical writing in general and research papers in particular.

Citation preview

Page 1: How to write papers - A note on Technical Writing

31st March 2011Technical writing -kpmdas 1

HOW TO WRITE PAPERS ?

A brief note on

TECHNICAL WRITING

Prof K P Mohandas

Page 2: How to write papers - A note on Technical Writing

Creative or literary writing

Creative writing

Poems

Short stories

Novels

Travelogues

Essays

Blogs,

Tweets etc

31st March 2011Technical writing -kpmdas 2

Page 3: How to write papers - A note on Technical Writing

Technical writing

Project proposals research grants

Status Reports of projects in progress/

completed

Seminar Reports

Technical papers for journals, conferences

Research papers on topic of research

Synopsis or abstracts of thesis

Thesis reports for award of a degree

31st March 2011Technical writing -kpmdas 3

Page 4: How to write papers - A note on Technical Writing

Technical Papers - types

Choice of type of paper

Research paper for journals

Research paper for conferences

Survey paper or review paper

Summary of research

Update on recent research

31st March 2011Technical writing -kpmdas 4

Page 5: How to write papers - A note on Technical Writing

Review papers or invited papers

Reviews the ‘state of the art’ and suggests future

directions of research.

Written by authors who have worked in the area

for ten or more years

Pertaining to a particular topic(area) of research

Reviews critically most of the work done earlier

Suggests future directions of research

Example : Papers in IEEE Proceedings or Special

Issues on topics

31st March 2011Technical writing -kpmdas 5

Page 6: How to write papers - A note on Technical Writing

Research papers

Contents on original research by author(s)

Part or whole of the work may be done for

the award of a degree.

Publication of a research paper guarantees

minimum quality of the work (mostly journal

papers)

Journal Papers are reviewed thoroughly and

published sometimes only after several

revisions

31st March 2011Technical writing -kpmdas 6

Page 7: How to write papers - A note on Technical Writing

Journal Papers

Journal papers have to be submitted according to the formal specified by the editors.

Instruction to authors available for reference in journals or on website.

Thorough review by five reviewers

Reviewers are chosen from expert researchers in the area.

Very often review may be anonymous

Only quality and originality of the work counts, nothing else

31st March 2011Technical writing -kpmdas 7

Page 8: How to write papers - A note on Technical Writing

Category of journal papers

Many journals have categories based on :

importance of the contribution

number of printed pages

For example,

IEEE Transactions, few of them have:

Full paper (3-6 pages) completely

original work like that of a PhD

Short paper (1-2 pages)

Technical Notes/ Correspondence ( part of a column or one page giving a comment or

correction on earlier published

31st March 2011Technical writing -kpmdas 8

Page 9: How to write papers - A note on Technical Writing

Difficulty in getting a journal papers published

Review and acceptance takes long time – even one year or more : 2 yrs for publication

One or more revision may be required

Number of pages restriction – extra pages not allowed very often

If allowed , may require page charges to be paid to meet part of cost of publication.

Only very high quality work published in standard journals like IEEE, ASME Transactions etc

31st March 2011Technical writing -kpmdas 9

Page 10: How to write papers - A note on Technical Writing

Conference papers

Easier to be accepted

Less thorough review process

Quick publication to establish claims of originality

Papers accepted in International conferences approved by professional societies like IEEE considered high quality

Paper has to be prepared in photo-ready templates

Proceedings published in society website

Permits author(s) to attend and present the papers personally and

Make contacts with people working in same area

31st March 2011Technical writing -kpmdas 10

Page 11: How to write papers - A note on Technical Writing

Technical Reports – proposal for grants

Research proposals are submitted to agencies for research grants

Proposals should be on topics of interest to the agency to which it is submitted

Clear statement of work to be done

Equipment with complete specifications and cost involved

Methodology to be clearly defined

Estimate of expenditure involved (both capital and recurring)

Time frame with plan of action in phases

Feasibility studies and usefulness to be established

31st March 2011Technical writing -kpmdas 11

Page 12: How to write papers - A note on Technical Writing

Status Reports on ongoing projects

Brief summary of project with problem,

methodology, time frame and cost

Briefly give work done before the period

Highlight the work done during the review

period

Update of expenditure incurred and review of

estimate, if required due to cost escalation

Generation of additional revenue

realization

31st March 2011Technical writing -kpmdas 12

Page 13: How to write papers - A note on Technical Writing

Technical Reports on completion of project

Details of work done

Outcome of the project

Patents

Publications

Usefulness to Industry

Details of expenditure incurred

Realization of short fall if excess

Refund of balance if less spent

Disposal / utilization of assets procured

31st March 2011Technical writing -kpmdas 13

Page 14: How to write papers - A note on Technical Writing

Literature survey

Required for all technical work / report/ research

Library resources – books, back volume journals,

current journals

On line contents and resources

Search engines : google.com ,

scholar. google .com etc

Communications from peers

News papers articles

Conference Proceedings

31st March 2011Technical writing -kpmdas 14

Page 15: How to write papers - A note on Technical Writing

General layout of a paper

Introduction

Problem statement

Body of the paper

Review of earlier work

Relevance of the present work

Results

Conclusions and suggestions for future work

References

31st March 2011Technical writing -kpmdas 15

Page 16: How to write papers - A note on Technical Writing

Papers on original research

Highlight the relevance and usefulness

Review earlier work done

Critically analyze what is wrong or

inadequate with earlier work

Statement of the problem discussed

Describe the methodology

Results

Conclusions

31st March 2011Technical writing -kpmdas 16

Page 17: How to write papers - A note on Technical Writing

Language and grammar

Why technical English is different from English in creative writing.

Mostly in third person, no use of “ I, you, We “

Simple words, short sentences

Describe uncommon technical words (if necessary at least in Appendix)

Describe all abbreviations

Describe all symbols

Check the spelling thoroughly using ‘spell check’ in Word processors

31st March 2011Technical writing -kpmdas 17

Page 18: How to write papers - A note on Technical Writing

Authors, order of mention of names

Research publications :

Name of the student who worked on the topic first, guides later

It is unfair practice to put the name of guide first

The hope that paper will be accepted if the guide’s name appears first is only ‘wishful thinking’

Reviews of good journals are done after masking the name of authors.

31st March 2011Technical writing -kpmdas 18

Page 19: How to write papers - A note on Technical Writing

Claims on work done – be modest

Do not exaggerate your claims

Tall claims can lead to trouble

Beware of others working in the same area

and same topic.

Duplication of efforts by different research

groups, sometimes independent

Publish early to establish claims

31st March 2011Technical writing -kpmdas 19

Page 20: How to write papers - A note on Technical Writing

Tables, Figures and Graphs

Table of numbers do not convey much, except increasing the number of pages

Use figures and graphs instead of tables wherever possible.

Clear diagrams of proper size

Flow charts for algorithms

Proper legends for diagrams, colour, if allowed

Choose type of graphs : bar charts, Pie charts, X-Y graphs depending on the situation

31st March 2011Technical writing -kpmdas 20

Page 21: How to write papers - A note on Technical Writing

Symbols and abbreviations

Describe all symbols properly

Avoid duplication of symbols

Arrange symbols in alphabetical order

Greek letters first

Lower case , upper case in that order

Expand all abbreviations when used first

List them in alphabetical order and give

expansion

31st March 2011Technical writing -kpmdas 21

Page 22: How to write papers - A note on Technical Writing

References -numbering

Number the references in the order it appears in the text or

Alphabetical order of names of authors with year in brackets

IEEE standard is to refer to them as [1] , [ 4-6] in the text and

List them as :

[1] David K Cheng : Linear System Analysis ….

[2] ………

31st March 2011Technical writing -kpmdas 22

Page 23: How to write papers - A note on Technical Writing

Details in references as per specifications

Books: Name of Author(s), Title of the Book, Publisher, Edition and year of publication, ISBN Number

Journal Papers: Authors, title of the paper, Name of the journal, Volume, Issue No and particular pages of the paper(pp).

Conference Papers: Author(s), Title, Name of the Conference or Proceedings, pages, place and date of the conferences

31st March 2011Technical writing -kpmdas 23

Page 24: How to write papers - A note on Technical Writing

Plagiarism – Integrity :be careful

Plagiarism :

"the wrongful appropriation, close imitation,

or purloining and publication, of another

author's language, thoughts, ideas, or

expressions, and the representation of them

as one's own original work.

Recently on the ascent due to the availability

of material and ease in ‘copy –pasting’

31st March 2011Technical writing -kpmdas 24

Page 25: How to write papers - A note on Technical Writing

Plagiarism – ‘cut and paste ‘ culture

The modern concept of plagiarism is an

immoral act

This idea emerged in Europe only in the 18th

century, particularly

In the previous centuries authors and artists

were encouraged to "copy the masters as

closely as possible" and avoid "unnecessary

invention.

31st March 2011Technical writing -kpmdas 25

Page 26: How to write papers - A note on Technical Writing

Never do ‘cut and paste’

You will be caught if you do that

Search engines have been developed by which

copying can be detected.

No knowledge is original, but do try to:

Understand what others have written

Rewrite in your own words

Copying without understanding and ‘copy

pasting’ is punishable all

31st March 2011Technical writing -kpmdas 26

Page 27: How to write papers - A note on Technical Writing

Teachers, a word of caution

Teachers are required to declare a work as Bona fide in a Certificate attached with thesis

Bona fide : Means in Good faith, or good intension (even if producing unfortunate results) or belief.

It is associated with the state of honesty, conviction to the truth . This concept is important in law, especially equitable matters.

In contemporary English, "bona fides" is sometimes used as a synonym for credentials or background, or documentation of a person's identity.

31st March 2011Technical writing -kpmdas 27

Page 28: How to write papers - A note on Technical Writing

In general – what is required in technical writing

You should have something to write other than summary of what others have done

You should think about how to present it in the best possible way

Consider the prospective readers or those who are hearing you

Follow the specified format for journal papers

Avoid personal references and tall claims

Never exceed the allotted time for conference papers presentations

31st March 2011Technical writing -kpmdas 28

Page 29: How to write papers - A note on Technical Writing

THANK YOU

31st March 2011Technical writing -kpmdas 29