Technical Writing Workshop

Download Report

Transcript Technical Writing Workshop

Technical Writing Workshop
Chemistry 162
Fall 2010
Workshop Objectives

Become familiar with the structure and style of
scientific writing

Get specific instructions for completing the
formal lab report

Learn to avoid common errors in formal
laboratory reports
Sections of a primary research
article







Title
Abstract
Introduction
Methods
Results
Discussion
References
Titles - style
Informative is better than indicative
“Migrating Birds Respond to Radar
Electromagnetic Fields” (informative)
“Effect of Radar Electromagnetic Fields on Bird
Migration” (indicative)
Titles - guidelines


Should be specific and concise
Avoid superfluous phrases
–
–


“Studies on…”
“Contributions to…”
No abbreviations
Consistent capitalization
Exercise 1

Write both an informative and an indicative title
for Lab 3 (Amino Acid Analysis).
Abstract - guidelines

One paragraph

<250 words

Avoid abbreviations

Limited or no citations
Abstract - content




Background (one clause)
Methods (very limited detail)
Results (key findings)
Conclusions (summarize)
Exercise 2

In small groups, identify each of the content
components in the assigned abstract. Grade
the abstract A-F.

Select one member of the small group to
present your findings to the rest of the class
Introduction - guidelines

3-5 paragraphs

Requires strong logical flow

Requires good paragraph organization
Introduction – content




Provide background by introducing the
scientific problem
Briefly review relevant prior research
Indicate what the present study will add to the
existing knowledge (state hypothesis to be
tested)
May end with statement of major result(s)
Exercise 3

Working in small groups:
–
–
–
–

Outline the Introduction of the assigned paper
Identify the scientific problem or hypothesis
Identify how the present study will address the scientific
problem
Grade the Introduction A-F.
Select a different person to present your outline and
grade to the rest of the class.
Results - guidelines

Length depends on amount of data presented

Avoid repetitive presentations of data

Avoid drawing conclusions
Results – style




Build a results narrative that “tells the story” of
your research
Organize the results to logically support the
problem/hypothesis being tested
Decide on appropriate presentation format for
each piece of data
Use the appropriate balance of methods
information
Discussion - content

Main message
–
Answers the problem posed in the introduction

How the data support the main message

Comparison of results to the literature

Overall conclusions and future work
Exercise 4

Outline the Discussion of the assigned paper.
Grade the abstract A-F.

Select a different member of the small group to
present your findings to the rest of the class.
References

Avoid paraphrasing – this is a form of
plagiarism

Follow ACS format in journal Biochemistry
Workshop Objectives

Become familiar with the structure and style of
scientific writing

Get specific instructions for completing the
formal lab report

Learn to avoid common errors in formal
laboratory reports
The Formal Lab Report

Include all sections except methods
–
–
–
–
–
–
Title
Abstract
Introduction
Results
Discussion
References
The Formal Lab Report

Should reference at least 2 primary research
articles
–
Should be cited in both Introduction and Discussion
The Formal Lab Report:
Protein Purification Results Data





A plot of protein concentration and enzyme activity
versus fraction number
A table showing activity, specific activity and fold
purification for the column fractions containing LDH
and the original mixture
The percent recovery of LDH
A picture of the SDS-PAGE gel and its associated
standard curve and the predicted sizes of the proteins
of interest
A copy of your HPLC chromatogram
Workshop Objectives

Become familiar with the structure and style of
scientific writing

Get specific instructions for completing the
formal lab report

Learn to avoid common errors in formal
laboratory reports
Common Formal Lab Report Errors:
Structure

Too much detail in the Abstract

Too long of Introduction
–

3-5 paragraphs sufficient
Repetitive presentation of data in Results
–
–
Text or Table or Figure
Do not present intermediate data (e.g. present only final
calculated protein concentration, not A280 and A260 and final
calculated protein concentration).
Common Formal Lab Report Errors:
Capitalization and Punctuation

Capitalization
–
–

Enzyme names are not proper nouns and don’t need to be
capitalized.
Capitalize all words except prepositions and articles in the title.
Punctuation
–
–
Follow a period with 2 spaces before starting the next
sentence.
Rf, not Rf .
Common Formal Lab Report Errors:
Tables and Figures

Generally, there are two types of non-text data: tables
and figures. Graphs, photographs, gels etc. should all
be presented as figures.

Table and figure legends should be titles and not
necessarily be complete sentences.
Common Formal Lab Report Errors:
Units

The units should be separated from the value by a
space. For example, one may write “The specific
activity of the protein in fraction 8 was 14,239 nmol
min-1 mg-1” or “The molecular mass of the protein was
17,500 kDa.”

There are two common formats for units. The most
common is to use superscripts (nmol min-1 mg-1), and
occasionally the dividing symbol is used
(nmol/min/mg).
Common Formal Lab Report Errors:
Abbreviations

Abbreviation should be minimized, but if used, define
the abbreviation at its first use. For example, one may
write “Purity of the lactate dehydrogenase was
analyzed by sodium dodecyl sulfate polyacrylamide gel
electrophoresis (SDS-PAGE) and reverse-phase high
pressure liquid chromatography (RP-HPLC).”

Abbreviation particularly should be avoided in the
Abstract.
Common Formal Lab Report Errors:
Miscellaneous Style Issues

“Fold purification”, not “fold of purification”.

Usually “In order to…” can be condensed to “To…”.

Enzyme names
–
Writing “the protein lactate dehydrogenase” or “the enzyme
lactate dehydrogenase” instead of the more simple “lactate
dehydrogenase” is akin to writing “the monument the
Washington Monument” instead of “the Washington
Monument”.
General issues

Remember elements of good writing
–
–
–

Sentence construction
Paragraph construction
Overall organization
Use of passive voice
Spelling Counts