Report Writing Guide
Report Writing Guide
Report Writing
Gurudutt R. Kamath
How We Communicate3
CVs, Resumes Email, Web site, FAQs Letters, Newsletters, Brochures, Articles, Catalogs Advertisements, Notice Board, Pamphlets, Signs, Press Release Presentations, multimedia, talks Reports, Manuals, Proposals, Books
Which Reports?
Sales Reports Inspection Reports Annual Reports Audit Reports Feasibility Reports Progress Reports White Papers
Classification of Reports
Formal Reports and Informal Reports Information Reports Analytical Reports Recommendation Reports
2.
3. 4. 5.
Define the problem Gather the necessary information Analyze the information Organize the information Write the report
Organizing Reports
Comparison/contrast Problem-solution Elimination of alternatives General to particular Geographic or spatial Functional Chronological
Denotation and Connotation Let me know when youre free next week for a meeting. Could you let me know what times you have free? Tone Terry is hung up on trivial details. Terry is meticulous and takes care of details that others sometimes ignore.
Writing Style
We do IT in Style!
Chicago Manual of Style Elements of Style by Strunk & White Dictionary Microsoft Manual of Style AMA Style Guide
Anatomy of a Report
Cover Page Title Page Letter of Transmittal Table of Contents List of Illustrations Executive Summary Report Body
Report Body
Introduction
Letter of Transmittal
Background Summarize conclusions and recommendations Minor problems. Thank those who helped. Additional research necessary Thank the reader. Offer to answer questions.
Sales Proposal2
Document Design
Use no more than 5 fonts. Use no more than 5 colors. Use glossy paper. Use white space. Use templates. Use parallelism. Avoid double emphasis.
Reference
1.
2.
3.
Business Communication, Kity O Locker and Stephen Kyo Kaczmarek, 2004 A Decent Proposal by John Fellows, www.sellingpower.com, 2002 Better Business Writing, The Sunday Times
Scientific Communication
Gurudutt R. Kamath
Scientific Papers
Why Publish?1
Readers can
Assess the observations you make Repeat the experiment if they wish Determine whether the conclusions drawn are justified by the data
IMRAD
Abstract brief summary) Introduction What question was asked? Methods How was it studied? Results What was found? And Discussion What do the findings mean?
(
Introduction
Why you have undertaken the study? Clarify what your work adds Keep it short Make sure you are aware of earlier studies Convince the reader Dont baffle the reader
Methods
Study Design
Who, what, why, when, and where? Randomisation, blind assessment Inclusion and exclusion criteria
Results
Discussion So What?
Finishing off
Perhaps Possibly More research is needed Heres another problem solved
General Points
Audience
Generalist Specialist
Titles
Interesting, concise, precise, not misleading, informative, descriptive, and appropriate for classification Developing a title in 4 steps Lileyman, 1988, p441
Nuclear reprocessing, radiation exposure, and childhood leukaemia: an epidemiological study
Abstracts
References
Uniform Requirements
Double spacing Margins Sequence
(25 mm)
Title, abstract, key words, text, acknowledgement, references, tables, legends to figures
IMRAD New page section, table Permissions (previous material) Required number of copies Electronic copy
Style
Clear, Accurate, Concise Short sentences, simple words, simple structures Jargon only if required. Noun clusters
Obstetric complication frequency Frequency of obstetric complications We compared the treatment group ...
More Style
(subgroup or
More women were alive five years after diagnosis. More women [than men] were alive five years after diagnosis.
Simple Words1
before more than depends on also indicates prior to in excess of is dependentant upon additionally is indicative of
After five days, the symptoms had improved. After five days, the symptoms had abated. Dermatitis is less often diagnosed Dermatitis was less prevalent symptoms are not well correlated with clinical disease severity. symptoms are not related to disease severity.
House Style
Director General or director general Beta-carotene or carotene Moslem or Muslim Mumbai or Bombay
Some Tips
Instructions to authors Study a few model papers, letters Read it out aloud Spell-check finally and Proof-read (missing not, or note)
References
1.
2.
3.
4.
References
Gurudutt Kamath
Documenting Sources
Quotes, ideas, numbers, facts, graphics, statistics, tables1 Websites, webpages, documents, pamphlets, film or video recording, CD-ROM, newspaper articles, songs, TV or radio programs, personal correspondence, email.
Documentation Style
Our study reports a significant rise in HIV cases in south Africa in one year (Brindle, 2000). Our study reported a 12.2% rise in HIV cases in only one year (Brindle, 2000, p. 843) Brindle (2000) reports a significant (Wu, Gyno, Young & Reims, 2003) As reported by Wu, Gyno, Young & Reims (2003) (Wu et al., 2003) or As reported by Wu et al. (2003)
(National Science Foundation [NSF], 2004) (NSF, 2004) Studies have shown (Johnson & Smith, 2001; Tamili, 2002; Hinson & Kim, 2004). Bathers (personal communication, December 5, 2003)
References (APA)1
Houghton, J. (1997). Global warming: The complete briefing (2nd ed). Cambridge, MA: Cambridge UP. Kadlecek, M. (1991). Global climate change could threaten U.S. wildlife. Conservationist 46 (1), 54-55 Sherwood, K, & Ido, C. (2003). Is the global warming bubble about to burst? Retrieved March 4, 2004, from the World Wide Web: http://www.co2science.org/edit/v6_edit/ v6n37edit.htm
Citation-Sequence (CBE) 1
This bacteria has been shown2 to Several studies 3-8, 10 have Several studies (3-8, 10) have Reference List (order of citation) Less disruptive vs refer to back for author, source
References
1.
2.
Business Communication
PAIBOC
Purpose Audiences Information Benefits Objections Context
Audience
Writer Initial audience Gatekeeper Primary audience Secondary audience Watchdog audience
Gender Race and ethnicity Regional and national origin Social class Religion Age Sexual orientation Physical ability
Bias-free Communication
Managers and their wives will Managers and their spouses will Manpower Personnel Manhours Hours or working hours Manning Staffing Workman Worker, employee, writer Chairman Chair, chairperson
Bias-free Communication
Use you.
You must work for your deparment.
Emails
Minutes a day - average worker? 49 minutes Hours a day - top managers? 4 hours Formats are still evolving What % felt misunderstood (2000)? 51% (tone)
Subject
Brief Important points at the top Bullets and numbering Emphasize (NOT) HTML (letterhead) ASAP, BTW, FYI, IMHO
Mailing Lists
Your boss could be reading! Posts are archived. Avoid using company email address. Avoid conversations (one liners). Do not rush to lists.
Netiquette
Never flame. Use FULL CAPS only to emphasize a word or two. Send messages on a need basis. Recipients work practice (one long or several short messages) Quote briefly (B/A) while replying. Attachments
References
1.
2.
3.
Business Communication, Kity O Locker and Stephen Kyo Kaczmarek, 2004 Better Business Writing, The Sunday Times, 2002 Model Business Letters, E-mails & Other Business Documents (sixth edition), Shirley Taylor
Technical Communication
Gurudutt R. Kamath
Importance
Improved productivity Improved use of product Increased safety Legal protection Reduces cost of training Reduces support Lesser chance of rejection
Audience3
Analysis
Surveys, questionnaires, structured interviews, usability tests
Characteristics
Educational, professional background Knowledge, experience level English language Context
Information Analysis
Textual Features
Overview, summary sections Step-by-step instructions Narrative explanations Conceptual models, analogies, and/or examples Figures, charts, and/or tables Cross-references and/or navigation aids Technical terminology, language conventions, and/or symbolic conventions
Media Characteristics
Articles narrative Booklets conversational Brochures catchy Newsletters journalistic Correspondence formal, informal Manuals action oriented Reports formal and objective Help systems action oriented Wizards concise and action oriented Websites catch and easy to use
Document Delivery
Print Facsimile Network Floppy disk FTP (file transfer protocol) Email attachment Website
Writing
Revising
Editing
Reviewing
Publishing
Writing Process
Document Plan
Audience Objective Media Resources Table of Contents Schedule
Outlining Template
Revising Process
Objective Complete Flow Language Grammar, Spelling, and Punctuation Graphics Format Consistency
Reviewing Process
Tools
Microsoft Outlook email Microsoft Word documents Microsoft Excel spreadsheets Microsoft PaintBrush drawings Adobe Acrobat PDF Microsoft FrontPage web pages Adobe FrameMaker large, complex documents Adobe PageMaker desktop publishing Adobe InDesign desktop publishing XML editors Macromedia RoboHelp Macromedia Flash
Modular
Easy to maintain Modular, reusable Right tools and templates
Parallelism
Grammar Active/Passive Voice
You
Consistency
Style Guides
House style
Consistent
Structured Writing
Lists Tables Graphics Instructions Tasks Concrete
Document Design
Maximum of 5 colours
Style Guides
Elements of Style
Strunk & White Grammar and Punctuation Writing tips http://www.bartleby.com/141