Michael Alley, Penn State
Writing as an Engineer or Scientist
  • Home
    • Scientific Presentations
    • Scientific Posters
    • Scientific Film
  • Reports
    • Reports Tutorial >
      • Reports Tutorial: Full
      • Badge: Writing Reports
    • Report Formats >
      • Sample Report Format
      • Report Templates
    • Laboratory Reports
    • Design Reports
  • Emails
    • Tutorial: Emails
    • Writing Professional Emails
    • Writing Professional Letters
    • Badge: Writing Emails
  • Research Papers
  • Grammar
    • Section 1: Grammar
    • Section 2: Punctuation
    • Section 3: Usage
    • Comprehensive Quiz
    • Badge: Grammar Errors
  • Teaching Resources
    • Short Films
    • Canvas Quizzes for Report Tutorials
    • Kahoots to Teach Writing
    • Craft of Scientific Writing >
      • Lessons >
        • 2: Being Precise and Clear
        • 3: Avoiding Ambiguity
        • 4: Sustaining Energy
        • 5: Connecting Your Ideas
        • 6: Being Familiar
        • 9: Emphasizing details
        • 10: Incorporating Illustrations
      • Errata
    • Why Our Students Struggle With Scientific Writing

Essence of Writing Reports

This lesson presents the essence of writing reports in engineering and science. Targeting engineering and science students who have not yet taken a technical writing course, this lesson focuses on avoiding the most common stylistic errors that young engineers and scientists make in their laboratory, design, and internship reports. Some errors discussed greatly affect a report's success. Other errors occur so frequently that they warrant discussion.  More detailed information for this lesson can be found throughout The Craft of Scientific Writing.

Lessons Home

Contents


Before You Write
1. Analyzing Audience, Purpose, and Occasion

Organization
2. Beginning of a Report
3. Middle of a Report: Writing in Sections

Language
4. Language: Being Precise and Clear
5. Language: Avoiding Ambiguity

Incorporating Illustrations and Equations
6. Incorporating Illustrations and Equations

Mechanics of Writing
Grammar (avoiding run-ons and fragments)
Punctuation (comma, colon,...)
Usage (affect/effect, verb tense, using numbers,...)

Review Questions

     After viewing the five films of this lesson, you should be able to answer the following questions about scientific writing.

Analyzing Audience, Purpose, and Occasion
  1. Once you have valuable content, what should be the next step in writing process of a scientific or technical document?
  2. What are the most important questions to ask about audience?
  3. How does persuasion affect a document?
  4. What does the word format mean? Is there one universal format in scientific writing (defend your answer)?

Organization of a Technical Document
  1. What makes for an effective title in scientific writing?
  2. Why do we have summaries in scientific writing?
  3. Why do we write longer scientific documents in sections?
  4. What makes for a good first sentence of a section in scientific writing? Is there only one way to write a first sentence in scientific writing--why or why not?

Language in a Technical Document
  1. At the sentence level, what are the most important goals?
  2. Should you exaggerate in scientific writing--why or why not?
  3. What did Einstein mean by the quotation, "Keep things as simple as possible, but no simpler."
  4. Should scientific writing be ambiguous--why or why not? What are three common sources of ambiguity in scientific writing?

​Incorporating Illustrations, Equations, and Abbreviations
  1. What are the four expectations that audiences of scientific documents have for the incorporation of an illustration?
  2. What is the convention for incorporating an equation into a scientific document?
  3. What is the convention for incorporating an abbreviation into a scientific document?

Instructor Lesson Plan

     On the following web page is a plan for instructors to incorporate this summary lesson into a class period within their course. Included with this plan are pre-class assignments, discussion questions, student activities, and a comprehension quiz. The class period accompanying this lesson is 1 hour.

References

  1. Alley, Michael, The Craft of Scientific Writing, 4th ed. (New York: Springer Verlag, 2018).
  2. Bernstein, Theodore, The Careful Writer (New York: Free Press, 1995).​​
  3. William A. Sabin, The Gregg Reference Manual: A Manual of Style, Grammar, Usage, and Formatting, 11th ed. (New York: McGraw-Hill, 2010).

Sponsors and Editors

Sponsors
     Leonhard Center, College of Engineering, Penn State
​     National Science Foundation, NSF EAGER Award 1752096

​Editors
     
Michael Alley, Teaching Professor, College of Engineering, Penn State
     Mikayla Detwiler, B.S. in Mechanical Engineering, 2020, Penn State
     Alexus Eicher, B.S. in Computer Science, 2020, Penn State
     Bridget Flynn, B.S. in Mechanical Engineering, 2020, Penn State
     Carrie McCartney, B.S. in Mechanical Engineering, 2020, Penn State
     Alyssa Peretin, B.S. in Mechanical Engineering, 2020, Penn State
​     Roman Pero, B.S. in Chemical Engineering, 2021, Penn State
     Kaitlyn Pigeon, B.S. in Industrial Engineering, 2020, Penn State
     Kayli Rentzel, B.S.. in Mechanical Engineering, 2020, Penn State


Film Editors
     
Richelle Weiger, College of Engineering, Penn State
     Casey Fenton, College of Engineering, Penn State
​     Elaine Gustus, College of Engineering, Penn State

Lessons Home


Film 1. Writing as an Engineer or Scientist: Analyzing Audience, Purpose, and Occasion.


Film 2. Writing as an Engineer or Scientist: Beginning of a Document.


Film 3. Writing as an Engineer or Scientist: Writing in Sections. Presenting in this film is Carrie McCartney (B.S. in Mechanical Engineering, 2020).


Film 4. Writing as an Engineer or Scientist: Being Precise and Clear in Your Sentences.


Film 5. Writing as an Engineer or Scientist: Avoiding Ambiguity.


Film 6. Writing as an Engineer or Scientist: Incorporating Illustrations, Equations, and Abbreviations.


​For the academic year 2019-2020, we are collecting comments, questions, criticisms, and suggestions for the films, text, and quizzes of each lesson on scientific writing. To help us understand your input, would please let us know what your discipline is and whether you are a student, professional, or faculty member?
Leonhard Center, Penn State 
University Park, PA 16802

Content Editor:

Michael Alley
​
mpa13@psu.edu