Cookies on our website

We use some essential cookies to make this website work.

We'd like to set additional cookies to understand how you use our site. And we'd like to serve you some cookies set by other services to show you relevant content.

assignment for technical report writing

  • Accessibility
  • Staff search
  • External website
  • Schools & services
  • Sussex Direct
  • Professional services
  • Schools and services
  • Engineering and Informatics
  • Student handbook
  • Engineering and Design
  • Study guides

Guide to Technical Report Writing

  • Back to previous menu
  • Guide to Laboratory Writing

School of Engineering and Informatics (for staff and students)

assignment for technical report writing

Table of contents

1 Introduction

2 structure, 3 presentation, 4 planning the report, 5 writing the first draft, 6 revising the first draft, 7 diagrams, graphs, tables and mathematics, 8 the report layout, 10 references to diagrams, graphs, tables and equations, 11 originality and plagiarism, 12 finalising the report and proofreading, 13 the summary, 14 proofreading, 15 word processing / desktop publishing, 16 recommended reading.

A technical report is a formal report designed to convey technical information in a clear and easily accessible format. It is divided into sections which allow different readers to access different levels of information. This guide explains the commonly accepted format for a technical report; explains the purposes of the individual sections; and gives hints on how to go about drafting and refining a report in order to produce an accurate, professional document.

A technical report should contain the following sections;

For technical reports required as part of an assessment, the following presentation guidelines are recommended;

There are some excellent textbooks contain advice about the writing process and how to begin (see Section 16 ). Here is a checklist of the main stages;

  • Collect your information. Sources include laboratory handouts and lecture notes, the University Library, the reference books and journals in the Department office. Keep an accurate record of all the published references which you intend to use in your report, by noting down the following information; Journal article: author(s) title of article name of journal (italic or underlined) year of publication volume number (bold) issue number, if provided (in brackets) page numbers Book: author(s) title of book (italic or underlined) edition, if appropriate publisher year of publication N.B. the listing of recommended textbooks in section 2 contains all this information in the correct format.
  • Creative phase of planning. Write down topics and ideas from your researched material in random order. Next arrange them into logical groups. Keep note of topics that do not fit into groups in case they come in useful later. Put the groups into a logical sequence which covers the topic of your report.
  • Structuring the report. Using your logical sequence of grouped ideas, write out a rough outline of the report with headings and subheadings.

N.B. the listing of recommended textbooks in Section 16 contains all this information in the correct format.

Who is going to read the report? For coursework assignments, the readers might be fellow students and/or faculty markers. In professional contexts, the readers might be managers, clients, project team members. The answer will affect the content and technical level, and is a major consideration in the level of detail required in the introduction.

Begin writing with the main text, not the introduction. Follow your outline in terms of headings and subheadings. Let the ideas flow; do not worry at this stage about style, spelling or word processing. If you get stuck, go back to your outline plan and make more detailed preparatory notes to get the writing flowing again.

Make rough sketches of diagrams or graphs. Keep a numbered list of references as they are included in your writing and put any quoted material inside quotation marks (see Section 11 ).

Write the Conclusion next, followed by the Introduction. Do not write the Summary at this stage.

This is the stage at which your report will start to take shape as a professional, technical document. In revising what you have drafted you must bear in mind the following, important principle;

  • the essence of a successful technical report lies in how accurately and concisely it conveys the intended information to the intended readership.

During year 1, term 1 you will be learning how to write formal English for technical communication. This includes examples of the most common pitfalls in the use of English and how to avoid them. Use what you learn and the recommended books to guide you. Most importantly, when you read through what you have written, you must ask yourself these questions;

  • Does that sentence/paragraph/section say what I want and mean it to say? If not, write it in a different way.
  • Are there any words/sentences/paragraphs which could be removed without affecting the information which I am trying to convey? If so, remove them.

It is often the case that technical information is most concisely and clearly conveyed by means other than words. Imagine how you would describe an electrical circuit layout using words rather than a circuit diagram. Here are some simple guidelines;

The appearance of a report is no less important than its content. An attractive, clearly organised report stands a better chance of being read. Use a standard, 12pt, font, such as Times New Roman, for the main text. Use different font sizes, bold, italic and underline where appropriate but not to excess. Too many changes of type style can look very fussy.

Use heading and sub-headings to break up the text and to guide the reader. They should be based on the logical sequence which you identified at the planning stage but with enough sub-headings to break up the material into manageable chunks. The use of numbering and type size and style can clarify the structure as follows;

  • In the main text you must always refer to any diagram, graph or table which you use.
  • Label diagrams and graphs as follows; Figure 1.2 Graph of energy output as a function of wave height. In this example, the second diagram in section 1 would be referred to by "...see figure 1.2..."
  • Label tables in a similar fashion; Table 3.1 Performance specifications of a range of commercially available GaAsFET devices In this example, the first table in section 3 might be referred to by "...with reference to the performance specifications provided in Table 3.1..."
  • Number equations as follows; F(dB) = 10*log 10 (F) (3.6) In this example, the sixth equation in section 3 might be referred to by "...noise figure in decibels as given by eqn (3.6)..."

Whenever you make use of other people's facts or ideas, you must indicate this in the text with a number which refers to an item in the list of references. Any phrases, sentences or paragraphs which are copied unaltered must be enclosed in quotation marks and referenced by a number. Material which is not reproduced unaltered should not be in quotation marks but must still be referenced. It is not sufficient to list the sources of information at the end of the report; you must indicate the sources of information individually within the report using the reference numbering system.

Information that is not referenced is assumed to be either common knowledge or your own work or ideas; if it is not, then it is assumed to be plagiarised i.e. you have knowingly copied someone else's words, facts or ideas without reference, passing them off as your own. This is a serious offence . If the person copied from is a fellow student, then this offence is known as collusion and is equally serious. Examination boards can, and do, impose penalties for these offences ranging from loss of marks to disqualification from the award of a degree

This warning applies equally to information obtained from the Internet. It is very easy for markers to identify words and images that have been copied directly from web sites. If you do this without acknowledging the source of your information and putting the words in quotation marks then your report will be sent to the Investigating Officer and you may be called before a disciplinary panel.

Your report should now be nearly complete with an introduction, main text in sections, conclusions, properly formatted references and bibliography and any appendices. Now you must add the page numbers, contents and title pages and write the summary.

The summary, with the title, should indicate the scope of the report and give the main results and conclusions. It must be intelligible without the rest of the report. Many people may read, and refer to, a report summary but only a few may read the full report, as often happens in a professional organisation.

  • Purpose - a short version of the report and a guide to the report.
  • Length - short, typically not more than 100-300 words
  • Content - provide information, not just a description of the report.

This refers to the checking of every aspect of a piece of written work from the content to the layout and is an absolutely necessary part of the writing process. You should acquire the habit of never sending or submitting any piece of written work, from email to course work, without at least one and preferably several processes of proofreading. In addition, it is not possible for you, as the author of a long piece of writing, to proofread accurately yourself; you are too familiar with what you have written and will not spot all the mistakes.

When you have finished your report, and before you staple it, you must check it very carefully yourself. You should then give it to someone else, e.g. one of your fellow students, to read carefully and check for any errors in content, style, structure and layout. You should record the name of this person in your acknowledgements.

Two useful tips;

  • Do not bother with style and formatting of a document until the penultimate or final draft.
  • Do not try to get graphics finalised until the text content is complete.
  • Davies J.W. Communication Skills - A Guide for Engineering and Applied Science Students (2nd ed., Prentice Hall, 2001)
  • van Emden J. Effective communication for Science and Technology (Palgrave 2001)
  • van Emden J. A Handbook of Writing for Engineers 2nd ed. (Macmillan 1998)
  • van Emden J. and Easteal J. Technical Writing and Speaking, an Introduction (McGraw-Hill 1996)
  • Pfeiffer W.S. Pocket Guide to Technical Writing (Prentice Hall 1998)
  • Eisenberg A. Effective Technical Communication (McGraw-Hill 1992)

Updated and revised by the Department of Engineering & Design, November 2022

School Office: School of Engineering and Informatics, University of Sussex, Chichester 1 Room 002, Falmer, Brighton, BN1 9QJ [email protected] T 01273 (67) 8195 School Office opening hours: School Office open Monday – Friday 09:00-15:00, phone lines open Monday-Friday 09:00-17:00 School Office location [PDF 1.74MB]

Copyright © 2024, University of Sussex

Logo for WisTech Open

Want to create or adapt books like this? Learn more about how Pressbooks supports open publishing practices.

Chapter 1: Introduction to Technical and Report Writing

Bay College

Learning Objectives

What is Technical Writing? [1]

You’re probably wondering what this “technical writing thing” is. Someone may even have told you, “It’s this course where they make you write about rocket science and brain surgery.” Well, not really, as you will see in a moment. Actually, the field of technical communication is essential in a wide range of fields and occupations. It is a fully professional field with degree programs, certifications, and—yes!—even theory. It’s a good field with a lot of growth and income potential; and an introductory technical-writing course for which this book has been developed is a good way to start if you are interested in a career in this field .

Technical writing is an audience-centered means of communication that provides a reader with clear and easy access to information. In the business world, time equates to profit, and profit is the force behind all business interaction. The technical writer and reader have a vis-à-vis relationship. The writer recognizes, respects, and addresses the importance of time in effective and efficient communication by providing documents written in specific formats, using unambiguous language to send clearly accessible information. The reader in turn thoroughly understands the information in order to give a thoughtful response.

The Meaning of “Technical”

Technical communication—or technical writing, as the course is often called—is not writing about a specific technical topic such as computers, but about any technical topic. The term “technical” refers to knowledge that is not widespread, that is more the territory of experts and specialists. Whatever your major is, you are developing an expertise—you are becoming a specialist in a particular technical area. And whenever you try to write or say anything about your field, you are engaged in technical communication .

Academic Writing Versus Technical Writing    

The definite purpose, strict format and use of appropriate language in technical writing define the differences between technical writing and academic writing.  The academic writer’s purpose may be to write an assignment, a story, a letter, etc.. These works may or may not have a reader. However, technical writing always has a definite purpose and will always have a reader.  Regardless of the number of the intended readers of a document who may or may not read the document, the document will be read by the primary reader.

Workplace Writing

However, the focus for technical-writing courses is not necessarily a career as a technical writer but an introduction to the kinds of writing skills you need in practically any technically oriented professional job. No matter what sort of professional work you do, you’re likely to do lots of writing—and much of it technical in nature. The more you know about some basic technical-writing skills, which are covered in this guide and in technical-writing courses, the better job of writing you’re likely to do. And that will be good for the projects you work on, for the organizations you work in, and—most of all—good for you and your career .

Really Technical Writing

Keep relaxing, but you should know that professional technical writers do in fact write about very technical stuff—information that they cannot begin to master unless they go back for a Ph.D. But wait a minute! The technical documents have to ship with the product in less than nine months! How do they manage? Professional technical writers rely on these strategies to ensure the technical accuracy of their work:

  • Study of books, articles, reports, websites related to the product
  • Product specifications: what the product is supposed to do, how it is designed
  • Interviews with subject matter experts: the product specialists, developers, engineers
  • Product meetings during the development cycle
  • Live demonstrations of the product
  • Familiarization with similar, competing products
  • Experimenting with working models of the product
  • Most importantly, subject matter experts’ review of technical writers’ work for technical accuracy and completeness

Of course, experienced technical writers will tell you that product development moves so fast that specifications are not always possible and that working models of the product are rarely available. That’s why the subject matter experts’ review is often the most important.

Considerations of Technical Documents

There are key components of what makes a document strong. Therefore, writers keep these items in mind while constructing technical documents.

The Importance of Audience

Another key part of the definition of technical communication is the receiver of the information—the audience. Technical communication is the delivery of technical information to readers (or listeners or viewers) in a manner that is adapted to their needs, level of understanding, and background. In fact, this audience element is so important that it is one of the cornerstones of this course: you are challenged to write about highly technical subjects but in a way that a beginner—a nonspecialist—could understand. This ability to “translate” technical information to non-specialists is a key skill to any technical communicator. In a world of rapid technological development, people are constantly falling behind and becoming technological illiterates. Technology companies are constantly struggling to find effective ways to help customers or potential customers understand the advantages or the operation of their new products .

Not only is the the level at which you write important but so are the language choices you make as you do so. Please review the information on the following link for tips: Use Language that is Sensitive to Your Audience [2]

So relax! You don’t have to write about computers or rocket science—write about the area of technical specialization you know or are learning about. Also, plan to write about it in such a way that even Grandad can understand !

Formatting and Language

Formatting and appropriate language are the basic design elements of all technical documents.  A format that shows a hierarchical structure and a coordinate structure of information  le ads the reader thorough text.

Textbook image

Readers should be able to identify a writer’s organizational pattern very quickly when reading a technical document . This sometimes refers to a document being “reader friendly.”  In addition , using appropriate language is significant in providing the reader with a thorough understanding of the purpose of the document, how the document relates to the reader’s needs, and what action is expected of the reader. [3]

A document may also have one reader (the primary reader) or several readers (the secondary readers). A primary reader is the person who ordered the report to be written or the person for whom a report is intended. These readers will usually read the entire report. Secondary readers are those readers who will read only the sections of the report that relate to them, their jobs, their departments, responsibilities, etc. For example, if a report was sent that detailed funding for different departments, a piping superintendent may only want to read the section that relates to piping. This is where format, the use of headings, is significant in allowing the reader easy access to information. When the piping superintendent can scan through the document and clearly find the heading that identifies his department saves time.

Cultural Communication

Technical writers need to be aware of the differences between the behavior and the norms, beliefs and values of specific cultural. According to Edward T. Hall and Mildred Reed Hall, In Understanding Cultural Differences, each culture operates according to its own rules (1990, pp. 3-4).  Hall and Hall add that problems occur when members of one culture apply the rules to another culture (1990, pp. 3-4). To communicate effectively with other cultures, the technical writer needs to not only be aware of rules governing behaviors that can be observed but also of the not-so-obvious rules that govern the norms, beliefs, and values of the people of a culture. The invisible rules of a culture dramatically impact the acceptance of ideas, plans, and strategies.  The Cultural Iceberg illustrates patterns of world communication, showing indicators of Institutional Culture (the obvious behavior of a culture), which can be clearly seen as the tip of the iceberg, and People Culture (the norms, beliefs and values of a culture), which cannot be seen and which are the barriers to successful communication .

Figure 2 The Cultural Iceberg

The Cultural Iceberg. Awareness is the top part of the iceberg. It includes Institutional Culture/Behavior such as government, education, economy, language, and laws. The hidden part of the iceberg is Unawareness of people's culture/cultural norms, values, and beliefs. It includes the concepts of time, space, and humor; intelligence; status; competition/cooperation; and theory of past and future.

Technical writers have a responsibility to their readers and to their employers to follow ethics when writing reports. 

Law and Ethics Text with Watch

Technical writers must use words that demonstrate valid appeals to reason, avoiding emotional words and phrases that appea l to basic emotion instead of justifiable reasoning. In addition, technical writers must use valid references to support ideas and strategies, avoiding referencing non experts to sway readers’ support. Also, technical writers must use accurate numbers to report data, avoiding charts and tables that skew data. Using any type of fallacies in technical writing is unethical and could result in dire consequences.

Not only do technical writers have a responsibility to report accurate information, but they also have a responsibility to credit accurate sources of information. At no time is it acceptable to rearrange information in order to attempt to indicate that the writer is the source of someone else’s idea or to indicate that the writer read a report that included information he/she cited, when the primary source of the information was cited in another report.  All sources must be referenced accurately in the text and cited on a reference page.

Daniel G. Riordan (2005), in Technical Report Writing Today, cites Dombrowski to define three threads of ethics:

One major thread is that the communicator must be a good person who cares for the audience. Communicators must tell the truth as convincingly as possible, because truth will lead to the good of the audience. Another thread is that the communicator must do what is right, regardless of possible outcomes. A third thread is that communicators must act for the greatest good for the greatest number of people (p. 16) .

In addition, Riordan (2005) references the “code of ethics of the Society for Technical Writers, and cites five of the code’s tenants:

My commitment to professional excellence and ethical behaviors means that I will …

  • Use language and visuals with precision.
  • Prefer simple direct expression of ideas.
  • Satisfy the audience’s need for information, not my own need for self-expression.
  • Hold myself responsible for how well my audience understands my message.
  • Report the work of colleagues, knowing that a communication problem may have more than one solution (Riordan, 2005, pp. 15-16) .

Hall, E. T. & Hall, M. R. (1990). Understanding Cultural Differences. Yardmouth: Intercultural Press, Inc.

Riordan, D. G. (2005).  Technical Report Writing Today.  Boston: Houghton Mifflin Company.

Visuals & Readability

To make a document more reader friendly, many technical writers rely on visuals to achieve this goal. [5] For example , la bels, callouts and captions are identifying text for graphics . Labels and callouts identify specific elements or features on a graphic; whereas captions are short phrases or sentences that describe the graphic. Notes, or footnotes, explain, or give credit.

Labels and Callouts

To identify specific elements or features, labels and captions are placed directly on the graphic or near it. “Although the terms are used interchangeably, labels are text identifiers that are self-explanatory in an image, while callouts are labels that require further information outside the image to explain what they are identifying” (Gurak 304). They supplement the visual information. But use them selectively; use them only if readers need them (Rude 116).

The advantage of labels is that the reader gains a basic understanding of elements in the graphic without referring to supplementary explanations. But, too many labels obscure the image. In this case, callouts are the better option. Use numbers or letters to identify each element and the supplementary explanations.

Guidelines for Creating Labels and Callouts

  • Determine the number of items to identify in the image (Gurak 308).
  • Estimate how much explanation each item requires to determine if labels or callouts are more appropriate (Gurak 308).
  • create a consistent visual style (Gurak 308)
  • use the same terms on the label or callout as in the text (Rude 116)
  • in general, all parts mentioned in the text should have a label or callout, and all parts with a label or callout should be mentioned in the text. (Rude 116)
  • Use a standard font and size for readability (Rude 116)
  • Align the labels and callouts for a neater appearance (Rude 116)
  • If callouts are used, place the explanatory text in a key next to the graphic.

Labels can take different forms (Gurak 304 – 306):

  • They may be placed directly on the graphic (whereby they become part of the graphic).
  • They may be placed around the graphic and use lines to point to the relevant element in the graphic.
  • Online, labels can be links or hotspots whereby more information about the element is displayed on mouse rollover.

This is an example of l abels placed directly on the graphic.

Map of Central Park with labelled streets and park areas.

Figure 3 Map of the West Side Central Park, NYC between 102nd and 110th Streets.

Here, the labels are placed around the graphic.

Drawing of a flower with all parts labelled with lines to their placement on the drawing.

Figure 4 Parts of a flower.

In this sample, when the mouse is rolled over the ‘Firebox’ label, the text will read: “Literally a box containing the fire. It is surrounded by water on the top and all sides. The bottom is a grate with an ash pan below that.” Additional information is displayed .

Anatomy of a steam locomotive. Each part of the train is labelled with a line to the part.

Figure 5 Labels as hotspots.

Callouts are best used when many parts of the image need to be labeled and each part requires a longer explanation. In fact, the label sequence may be in alphabetical or numerical (as in Figure 6) order. Ensure that the explanation is near the graphic.

Sample Nutrition Facts label from Macaroni and Cheese. Call outs on the left side point to different parts of the label, such as Start Here, Check Calories, Limit these Nutrients, Get Enough of these Nutrients, Footnote, and the Serving Size.

Figure 6. How to understand and use the Nutrition Facts Label.

Coded callouts are in numerical sequence; the explanation for each number appears below the graphic. The example above shows part of the explanation of Number 1 explanation only.

Captions, table, and graphics titles must clearly identify information to the reader. Interpretive captions usually require one or more sentences. Captions should be informational, without becoming too lengthy. Captions that are merely a title for a graphic are not very helpful (Franklin 96).

Writing Style for Captions

  • Captions for graphics include the title and any explanatory material, immediately under the graphic.
  • Words such as Figure, Illustration, and Table should be in bold type.
  • The caption should be italicized.
  • Treat tables and figures the same.

Good captions are what guide readers not only to see, but also to understand. Captions label graphics with titles and explain to readers what they are seeing, and how to interpret the information captured in the visual. The Franklin Covey Style Guide for Business and Technical Communication provides an excellent source for writing captions (Franklin 39 – 41).

Five Specific Style Rules

  • Use interpretive captions whenever possible. I nterpretive captions provide both a title and explanatory information, usually expressed in a complete sentence, to help readers understand the central point(s) that the writer wants to convey. A graphic and its caption should be clear and understandable without requiring readers to search for clarifying information in the text:
  • Figure 4. Cabin-Temperature Control System. Constant cabin temperature control is maintained by the system’s modulated cabin sensor.
  • This interpretive caption gives the title and then tells the reader the principle message – that the check valve provides near-zero risk. And, it states how the check valve provides near-zero risk (Franklin 39).
  • Figure 23. Check Valve . The risk of bad air entering the changer is near zero because the check valve permits air flow in one direction only.
  • This interpretive caption gives the title of the figure and emphasizes that the cabin has a constant temperature – a benefit provided by the feature described in the figure. The caption states clearly what the writer wants the reader to learn from the drawing (Franklin 39).
  • Avoid using short, often ambiguous, titles to replace interpretive captions. In the past, styles for technical and scientific documents used only short, simple title captions for visuals. These were often superfluous, providing no real information other than the obvious to the reader, i.e. – A Horse. Titles that are so short and cryptic that they sound telegraphic are not useful. Such captions are only useful when the graphics are self-explanatory, and require no interpretation (Franklin 40).
  • Number figures and tables sequentially throughout the document, and place the number before the caption. If an important figure or table is presented twice, treat it as two separate visuals and number each. Figure and table numbers should be whole numbers (Franklin 40).
  • Captions may appear below or above a visual, but consistency throughout a document is critical. Arguments support both options; choose one, warrant your choice, and be consistent.
  • Put the caption above the visual for better visibility when captions are used with slides and other project visual aids. Captions placed at the bottom may be blocked by the heads of those seated in front (Franklin 99).

Notes or footnotes are categorized as either explanatory or source notes. Explanatory footnotes are identified by a superscript number or letter. The order in which notes appear is important; explanatory footnotes are placed above source notes. And both are placed above the caption, if the caption is placed at the bottom of the illustration.

A pie chart about Toxic Chemical Releases. Below the chart, a footnote is listed with a source note and caption.

Figure 7. Placement of footnote, source note and caption.

Source: Rude, p. 115, modified.

The Writing Process [6]

Writing, especially when compiling a larger document,  is not something you sit down, complete in one session, and quickly submit. This is especially true when writing for the workplace where accuracy and clarity are necessary. In fact, writing should be seen as a process that is recursive where the writer moves in and out of various stages of writing and often times revisits some of the stages. The writing process might consist of the following:

This is the planning done before writing a document. It may be defining the purpose of the task, analyzing the primary and secondary readers, sketching the document and what will go in each section, or gathering research.

This is writing and compiling a first draft of the document. Sometimes, the writer worries more about getting ideas down more than guaranteeing every punctuation or grammar choice is correct.

When a writer revises, a writer revisits the draft and makes substantial changes to it. This is more than editing. It is adding, deleting, and moving entire sections of the document around to prepare it as a final, comprehensive document. In fact, it is here that many writers ask others for feedback before revising to ensure that another, unbiased set of eyes have looked over the document and easily understand it.

This is the final part of the process. It is reading through the document several times while looking for clarity, consistency, and accuracy. In fact, consider reading your document aloud and listening to it as you do so instead of reading and “seeing” it. Most individuals communicate mostly through talking and listening. Therefore, when you read aloud, you can hear if something in your document doesn’t sound right and then correct it. You should be able to read it in a way that it is understandable and sounds conversational.

For additional information on the writing process, visit The Writing Center website for the University of Texas: University of Texas Writing Center & The Writing Process .

Using a process in the workplace and in our class will strengthen your documents significantly. In fact, remember that your documents reflect on who you are as student, technical writer, employee, and even researcher.

[1] Technical Writing. Authored by : Dr. Elizabeth Lohman. Provided by : Tidewater Community College. Located at : http://www.tcc.edu/ . Project : Z Degree Program. License : CC BY: Attribution , edited by Amber Kinonen , edits included in italics

[2] Use Language that is Sensitive to Your Audience. Provided by : Writing Commons. Located at : http://writingcommons.org/open-text/collaboration/143-common-comments/word-choice-/575-use-language-that-is-sensitive-to-your-audience . License : CC BY-NC-ND: Attribution-NonCommercial-NoDerivatives edited by Amber Kinonen , edits included in italics

[3] Image of Textbook. Authored by : Dominik Wagner. Located at : https://flic.kr/p/eoAvCb . License : CC BY: Attribution

[4] Image of Text with Watch. Authored by : Stephen Wu. Located at : https://flic.kr/p/tZ1LP . License : CC BY-NC-ND: Attribution-NonCommercial-NoDerivatives

[5] Norbert Elliot’s “Labels, Callouts, Captions and Notes” CC-BY Saylor, edited by Amber Kinonen , edits included in italics

[6] The Writing Process CC-BY Amber Kinonen

Chapter 1: Introduction to Technical and Report Writing Copyright © by Bay College is licensed under a Creative Commons Attribution 4.0 International License , except where otherwise noted.

Share This Book

  • PRO Courses Guides New Tech Help Pro Expert Videos About wikiHow Pro Upgrade Sign In
  • EDIT Edit this Article
  • EXPLORE Tech Help Pro About Us Random Article Quizzes Request a New Article Community Dashboard This Or That Game Popular Categories Arts and Entertainment Artwork Books Movies Computers and Electronics Computers Phone Skills Technology Hacks Health Men's Health Mental Health Women's Health Relationships Dating Love Relationship Issues Hobbies and Crafts Crafts Drawing Games Education & Communication Communication Skills Personal Development Studying Personal Care and Style Fashion Hair Care Personal Hygiene Youth Personal Care School Stuff Dating All Categories Arts and Entertainment Finance and Business Home and Garden Relationship Quizzes Cars & Other Vehicles Food and Entertaining Personal Care and Style Sports and Fitness Computers and Electronics Health Pets and Animals Travel Education & Communication Hobbies and Crafts Philosophy and Religion Work World Family Life Holidays and Traditions Relationships Youth
  • Browse Articles
  • Learn Something New
  • Quizzes Hot
  • This Or That Game
  • Train Your Brain
  • Explore More
  • Support wikiHow
  • About wikiHow
  • Log in / Sign up
  • Education and Communications
  • Technical Writing

How to Write a Technical Report

Last Updated: September 28, 2023 Fact Checked

This article was co-authored by wikiHow staff writer, Christopher M. Osborne, PhD . Christopher Osborne has been a wikiHow Content Creator since 2015. He is also a historian who holds a PhD from The University of Notre Dame and has taught at universities in and around Pittsburgh, PA. His scholarly publications and presentations focus on his research interests in early American history, but Chris also enjoys the challenges and rewards of writing wikiHow articles on a wide range of subjects. There are 7 references cited in this article, which can be found at the bottom of the page. This article has been fact-checked, ensuring the accuracy of any cited facts and confirming the authority of its sources. This article has been viewed 84,604 times. Learn more...

Engineers, scientists, and medical professionals need to be good writers too—and technical reports prove it! A good technical report presents data and analysis on a specified topic in a clear, highly-organized, and effective manner. Before you begin writing, define your message and audience, and make an outline. Then, write the main body of the report and surround it with the other necessary sections, according to your chosen layout.

Technical Report Outline

assignment for technical report writing

Planning Your Report

Step 1 Establish the message you want to convey through the report.

  • For instance, you may want to convey the message that a new technique for extracting a particular chemical compound is both safer and more cost-effective.
  • The best technical reports remain clear and focused throughout—they have a specific purpose and convey the information in a logical order.
  • Work with advisors, supervisors, or colleagues to fine-tune the message and/or goal of your report. These can vary widely depending on whether the report is being produced for academic, business, or other purposes.

Step 2 Define your audience before you begin writing.

  • If others in your field will be reading the report, it can be more “technical” in language and detail. In many cases, though, technical reports are intended for those outside of your particular discipline. If so, cut back on the jargon for non-expert readers.
  • Consider having a non-expert friend look over your report throughout the process to give you feedback on its accessibility to a broad audience.

Step 3 Create an outline to follow while you write.

  • Determine which particular sections your report must or may have. Consult the person or organization to whom you’ll be submitting the report for any layout requirements.

Writing the Main Body of the Report

Step 1 Create a thorough but focused introduction to the report.

  • In most cases, the introduction will likely be 1-3 paragraphs in length.
  • The end of the introduction should clearly state what the report “does.” It might do so by way of a direct statement (“This report analyzes…”), or by providing a series of questions (which may in some cases be bulleted or numbered) to be addressed.

Step 2 Provide background information and/or a literature review in the next section.

  • Essentially, you want readers who may be new to the subject matter to feel like they have at least a rudimentary grasp of it after reading this section.

Step 3 Follow up with a clear and detailed project description.

  • If, for instance, your report is focused on a particular experiment, be specific on the way it was conceived, set up, and conducted.
  • This is sometimes called a “methods” section, since you are describing the methods used to conduct your research.

Step 4 Present your data and describe what it all means in the next sections.

  • It can be hard to determine how much data to present. Giving too little can significantly weaken your analysis and the overall report. Giving too much, however, can drown the reader in a sea of tables and figures. Make sure you provide all essential data, and err on the side of providing a bit too much unless otherwise instructed.
  • Present your data in a logical order, so that each table or figure leads into the next one.

Step 5 Round out the...

  • Be as bold in your conclusions as your data and analysis permits you to be. Don’t use terms like “might,” “perhaps,” “could,” and so forth—write something like, “The data shows that…” However, don’t draw conclusions that aren’t supported by your data.

Adding Components in the Proper Layout

Step 1 Check for specific guidelines with your university, employer, etc.

  • Executive Summary
  • Table of Contents
  • List of Figures / List of Tables
  • Main Report: Introduction; Background / Literature Review; Project Description; Data / Description of Data; Conclusion
  • Acknowledgements

Step 2 Create a simple title page at the beginning of your report.

  • Write the abstract after you’ve written the actual report. You want it to be a condensed description of what you have written, not of what you intend to write.
  • Check to see if there is a specific word limit for your abstract. Even if there isn’t, 300 words is a good word limit to aim for.

Step 4 Create an executive summary that condenses the report by about 90%.

  • The executive summary should focus on your findings, conclusions, and/or recommendations, and allow the report itself to present the data—although highlights of the data should be provided.
  • Depending on your situation, you may need to write an abstract, an executive summary, or both.

Step 5 Draw up a table of contents, list of tables, and list of figures.

  • Check for any formatting guidelines for these sections. If the format is left up to you, keep things simple and straightforward.

Step 6 Follow the main body of the report with an acknowledgments section.

  • This section typically runs 1-2 paragraphs, and follows a fairly simple “The author would like to thank…” format.

Step 7 Include citations in the references section, using a consistent format.

  • In some cases, you may also be expected to provide a listing of works you have consulted but not specifically cited in the work. Check with the relevant department, organization, individual, etc., if you’re not sure. [13] X Research source

Step 8 Use appendices...

  • Use a consistent, easy-to-navigate format when creating appendices. They aren’t meant to be dumping grounds for random snippets of data or information.

Expert Q&A

You might also like.

Write an Expression of Interest

  • ↑ https://students.unimelb.edu.au/academic-skills/explore-our-resources/report-writing/technical-report-writing
  • ↑ https://www.sussex.ac.uk/ei/internal/forstudents/engineeringdesign/studyguides/techreportwriting
  • ↑ http://homepages.rpi.edu/~holguj2/CIVL2030/How_to_write_search/How_to_write_a_good_technical_report.pdf
  • ↑ https://www.theiet.org/media/5182/technical-report-writing.pdf
  • ↑ http://www.sussex.ac.uk/ei/internal/forstudents/engineeringdesign/studyguides/techreportwriting
  • ↑ https://students.unimelb.edu.au/academic-skills/explore-our-resources/report-writing/executive-summaries
  • ↑ https://openoregon.pressbooks.pub/technicalwriting/chapter/10-4-table-of-contents/

About This Article

Christopher M. Osborne, PhD

  • Send fan mail to authors

Reader Success Stories

Nafees

Nov 2, 2019

Did this article help you?

Am I a Narcissist or an Empath Quiz

Featured Articles

100+ Good Morning Texts for Her (& Other Ways to Make Her Smile)

Trending Articles

How to Make Money on Cash App: A Beginner's Guide

Watch Articles

Make Homemade Liquid Dish Soap

  • Terms of Use
  • Privacy Policy
  • Do Not Sell or Share My Info
  • Not Selling Info

wikiHow Tech Help Pro:

Develop the tech skills you need for work and life

Assignment Design

The most updated lab writing instructional modules are available: engineeringlabwriting.org

Learning Objectives

Although all engineering instructors “know how to write”, they may struggle with assigning writing projects to students. Well-designed writing assignments lead directly to student learning. Traci Gardner from National Council of Teachers of English identifies three goals for a writing assignment:

  • Define the writing task.
  • Explore the expectations.
  • Provide supporting materials and activities.

In the context of lab report writing, engineering instructors need to address the following to students as explicitly as possible when preparing lab report assignment:

  • The audience (Specific people like instructors? engineers? peers? public?).
  • The pedagogical purpose of the lab report (Why is the assignment given?).
  • The “fictitious” professional purpose of the lab report (Why is the assignment given?).
  • Specific requirements (if there are any).
  • Checklists or Presentation Expectations (format, submission, deadline, etc.).
  • Assessment rubrics (or any type of grading guidelines): The details of assessment rubric design and development are introduced in the Lab Report Assessment Rubric Module Assessment Rubric Design .
  • Acceptable sample reports with or without addressing the standard conventions of finished and edited texts.
  • Unacceptable sample reports with or without addressing the standard conventions of finished and edited texts.
  • List of recommended reading resources.
  • Other resources to assist students’ writing process.

Sample 1: Lab Report (as a Technical Report) Writing Assignment

  • Overview: You (the writer of the report), a 2nd year engineering student, are assigned to write a technical report (the genre) to convey engineering and technical information, including the lab background, process, data, analysis results, and conclusion (the purpose of the report), to the instructor, the TA, and the peers (the audience of the report).
  • Lab Report Audience: Assume you are submitting the lab report as a technical report to a peer in class. Therefore, your audience is familiar with the lab materials; however, you need to explain the engineering and technical information as precisely as possible. The executive summary of your report should be able to be read by a professional audience such as industry partners, or other professors in the program.
  • Purpose of Lab Report: You are assigned to write a technical report on how your analytical analysis can be verified with the experimental results of the lab. Your report should include effective presentations of the lab data and thoughtful discussion based on the inspection, measurement, and test results. This lab requires conducting research with secondary sources (outside references available on the net and/or the library).
  • Required Lab Report Writing Style and Format: The technical reports are typically written using third-person perspective and past tense, and in many situations, an active voice provides better clarity and succinctness. One of the unique features of “technical reports” is a clear and easily accessible format. Technical reports need to be divided into sections that allow different readers to access different levels of information. Technical reports mostly consist of executive summary, introduction, methods, results, discussion, conclusion, and reference sections. Use the Metric System of units for this lab report.
  • Lab Report Submission: Please submit your completed lab report to the course website by the due date listed above. This allows you to have enough time to conduct data analysis and research with the secondary sources (references) as well as the primary sources (experimental data).

Sample 2: Lab Report (as a Research Paper) Writing Assignment

Assume you are an engineering intern working at the product design group of a company in the automotive industry, which may be similar to ABC Motors, City. Your boss, Ms. Boss, assigned you to conduct research on the mechanical properties and hardness of the materials used in a future project. Note that she is not asking you to pick the best material. All of these materials will be used for future vehicles because there are many parts and components. She will eventually share your report’s technical information with other engineers and/or people in the organization. For the project, three different material types such as 1018, 1045, and 4140 steels are considered. This means that you are assigned to write a lab report as a research paper primarily based on the testing results from the lab. This lab will provide you with the opportunities of reviewing knowledge on the mechanical properties and strengthening mechanisms of engineering materials (textbook chapters 6 and 7), conducting additional uniaxial tensile tests as well as hardness tests, conducting a comparative analysis with the obtained experimental data, and discussing the analysis with the outside sources or references in order to advance your knowledge.

In this experimental research paper, you can conduct a comparative study to compare three different steel samples in many different ways (e.g. 1018 vs 1045 to see the effect of carbon contents). In order to write a good research paper, you need to have good research questions to discuss. Your engineering team and organization might have the following questions:

  • Any technical questions from your own.
  • What would the effect of the carbon and/or alloying element contents have on the mechanical properties (strengths, ductility, etc) of the samples?
  • Does the fracture look ductile, brittle, or moderately ductile for each coupon?
  • Which sample does have the highest yield strength and/or UTS, ductility, toughness, hardness, etc. values? Why?
  • What are the average hardness and standard deviation values of each coupon? Is there a visible deviation in the measurement? What are the possible sources of errors?
  • Textbook page 179 shows the relationship between the tensile strength and the hardness values in HB for most steels. Is this formula accurate?

In order to write a good report or earn high scores, you do not need to answer all of these questions and/or come up with difficult-to-answer questions. A good lab report possesses well-defined questions and well-developed answers supported by both your experimental data (primary sources) and further research results using the internet or reference books (secondary sources). A good report has a well-defined introduction, body, and conclusion. In the introduction section, write about what you want to discover in the report. The objectives provide guidance on what you are going to say to your audience (your boss and engineering team in this case) throughout the report. In the body section, you summarize the experimental methods so the audience can confirm your testing was sound. You present the experimental data clearly and discuss them to follow your objectives. In the conclusion section, you need to summarize the main points of the lab along with a very brief restatement of the objectives and lab procedure.

Please submit your completed lab report in PDF on the course website by the due.

Sample 3: Lab Report (Memorandum or Letter as a Format) Writing Assignment:

Prepare a technical memorandum for your submission. The content of most memoranda to the technical audience can be organized into four main parts: heading, introduction, body (methods, results, discussion), conclusions, and closing. Depending on the intent and length of the memo, each part can be as short as a single phrase or as long as several paragraphs. Most memos are less than two pages. The following elements should be included

  • Letter/Memo Heading – TO: (readers’ names and job titles), FROM: (your name and job title), DATE: (complete and current date), SUBJECT: (subject of the lab).
  • Introduction – Objective and overview. Within the first two sentences, the purpose of the letter or memo is clearly stated. Provides background context for the discussion and educates the reader so they can understand the discussion.
  • Body – Methods, data presentation/analysis/interpretation. Include a brief description of the methodology, relevant findings, interpretation of data, and other significant items, including a brief explanation of significant errors.
  • Conclusions and Recommendations – Should recapitulate results and conclusions and recommend future work or action.
  • Courteous Closing (Includes your contact information).
  • References – Should be of sufficient quantity and quality, and cited properly within the text. Bibliographic information is included as a footnote.

Additional information to the written text is often required. Typical attachments include:

  • All figures and tables discussed in text, but self-explanatory.
  • Numbered and properly titled, contain units, and axis labels.
  • Referenced (if information not created by author).
  • Appropriate to communicate effectively.
  • Attachment 2* – Test Set-up: clear and self-explanatory, photos, sketches…
  • Attachment 3* – Data: self-explanatory data sheet; proper symbols and units.
  • Attachment 4* – Calculations: clear and self-explanatory, sources cited.
  • Additional attachments as required

Submit the lab report to your TA by the due.

Sample 4: A technical memo as a lab report (a technical memorandum) writing assignment

Structural Materials Supply, Inc.  

3201 Campus Dr.  

Klamath Falls, OR 97601  

To:              Materials Testing Consultants  

From:          MJ  Johnson, Ph.D., P.E.  

Date: June 24, 2022  

Subject:        Creep deflection of bookshelves  

Structural Materials Supply, Inc. is developing a line of bookshelves for use by prominent commercial office suppliers. Creep of bookshelves is a well-recognized problem across the industry. While we recognize that elastic deflections can be significant for heavily loaded shelves, we would like your help estimating the creep behavior of the Douglas-Fir beams we intend to use. Please help us determine a mathematical model of creep that can be used to predict long-term creep deflections so that we can further refine our product to meet long-term performance goals.   

Specifically, we would like you to load a 1×6 Douglas Fir beam with enough weight to observe creep deflections. Please collect deflection versus time data, fit with an appropriate trendline, and predict long-term creep deflection at 100 years. Provide a description of creep behavior and let us know if we should be concerned about it in our products.   

Please present your response in the form of a technical memorandum employing the IMRADC format. Submit this memo as a pdf along with a copy of the Excel file you developed to analyze the data.  Thank you in advance for your attention to detail and professional work.   

Logo for Milne Publishing

Want to create or adapt books like this? Learn more about how Pressbooks supports open publishing practices.

Introduction

The purpose of a technical report is to completely and clearly describe technical work, why it was done, results obtained and implications of those results. Following the guidelines provided in this document should lead to a well-written technical report that allows the reader to quickly understand what has been accomplished, regardless of the summative or formative nature of the work, and establishes the credibility of the work. The report also provides sufficient detail for the reader to appreciate how the results were collected and possibly recreate the results although the level of detail provided depends heavily on the report’s audience and any proprietary nature of the work. Although this document provides guidance for good lab report writing, chronicling work performed for a laboratory assignment as is done for the familiar academic lab report is not the same as producing a report on technical work. For example, technical reports commonly cite sources and include a bibliography often not expected in an academic lab report. However, these guidelines can be used in total to support formal technical report writing or referred to selectively depending on the type of report and level of formality required.

The key to a well-written report is organization. A report that is divided into several sections, occurring in a logical sequence, makes it easy for the reader to quickly obtain an overview of the contents as well as locate specific information. This document provides guidelines for producing a well-written technical report. The next section details what information to provide for the reader in each section of a report. That is followed by a description of how someone in the related technical industry, the likely reader of technical reports, typically peruses a report. This provides important context for recommended organization and content. Additionally, this document presents a list of questions authors should ask of themselves prior to final submission.

Technical Report Writing Guidelines Copyright © by Leah M. Akins is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License , except where otherwise noted.

Share This Book

Logo for Open Oregon Educational Resources

CH 7 Assignment: Instructions

Your task is to write a set of instructions related to your major/discipline or career. Please choose something at which you are an expert (or nearly one) and something that most people would not know how to do. Consider your audience to be intelligent but likely unfamiliar with the process.

The main purpose of this assignment is to give you practice in writing instructions, one of the most common types of workplace technical writing. Whether working with office staff, technicians, managers, or executives, technical communicators are frequently called upon to write instructions, such as specific office procedures, training manuals, and safety protocols.

Feel free to look at the sample sets of instructions in this textbook as well as ones found online to help you pick a format and structure—but, of course, your instructions must be your own.

An important aspect of instructional writing is the use of graphics and design: good instructions contain visuals and are designed to be easy to read and understand. Therefore, another important aspect of this assignment is to improve your skills in the use of visuals in technical documents.

*NOTE: Visuals should work to illustrate the writing rather than replacing it; in other words, don’t instruct the reader to complete the step in Figure 1 without also explaining the step in writing.

Your instructions should include both of the following:

  • A brief reflective memo :
  • Briefly summarize your process of developing and researching your instructions.
  • Briefly summarize your audience and purpose .
  • Discuss how you assessed your audience’s needs before writing your instructions. What did they already know? What did you have to explain and why?
  • Describe your formatting and visuals choices.
  • A complete set of printed instructions, including:
  • A clear introduction
  • Caution, warning, safety notices
  • Clear formatting with steps, sections, and subheadings
  • Visuals where appropriate (*be sure to properly cite your visuals)
  • A conclusion

Technical Writing at LBCC Copyright © 2020 by Will Fleming is licensed under a Creative Commons Attribution 4.0 International License , except where otherwise noted.

  • Advertise with us
  • Explore by categories
  • Free Online Developer Tools
  • Privacy Policy
  • Comment Policy

5 Essential Steps to Writing a Technical Report

  • March 16, 2023

Check out these 5 essential steps to writing a technical report.

5 Essential Steps to Writing a Technical Report

For virtual learning, online science projects are the best way for students to learn science and math. Building a simple space project is a great way to get started. To prepare for such projects, students can take virtual lessons on building and designing. With the right guidance, students can easily complete their projects and communicate their findings effectively. These virtual projects also provide a great opportunity for students to learn in a fun and engaging way while staying safe at home. So, if you're looking for a simple and effective way to learn science and math, consider trying some virtual building projects today!

Step 1: Identify the Purpose and Audience

The first step in writing a technical report is identifying the purpose and audience. The report's purpose will help you determine what information to include and how to structure the report. The report's audience will help you determine how to present the information and what level of technical detail to include.

For example, if you are writing a technical report on a physics project for an elementary school class, the report may be to explain the project to the teacher and classmates. The audience may be other students who are not familiar with the project.

To identify the purpose and audience of your technical report, start by asking yourself the following questions:

  • What is the purpose of the report? Is it to inform, persuade, or recommend?
  • Who is the intended audience? Is it a teacher, classmates, or a wider audience?
  • What level of technical detail is required? Is the report for an elementary school class or a college-level course?

By answering these questions, you can clarify the purpose and audience of your report and create a focused and effective document.

Step 2: Gather and Analyze the Information

The second step in writing a technical report is to gather and analyze information. This step is important because it ensures the report is accurate and credible. Gathering information from reliable sources will help you avoid errors and inconsistencies in your report. Analyzing the information will help you determine what is relevant and how it should be presented in the report.

To gather and analyze information for your technical report, follow these steps:

  • Identify your sources. Look for reputable sources such as scientific journals, textbooks, and government websites.
  • Collect your data. Record and organize your data in a spreadsheet or other tool.
  • Analyze your data. Determine what is relevant and what can be left out of the report.
  • Use graphics. Use tables, charts, and graphs to present the data in an easy-to-understand format.

By following these steps, you can ensure that your technical report is accurate, credible, and easy to understand.

Step 3: Organize and Outline the Report

The third step in writing a technical report is to organize and outline the report. This step is important because it ensures the report is structured logically and coherently. Organizing the report into sections and subsections will make it easier for the reader to follow and understand.

To organize and outline your technical report, follow these steps:

  • Create an outline. Create an outline of the report that includes the main sections and subsections.
  • Group similar information. Group similar information together under each section or subsection.
  • Use headings and subheadings. Use headings and subheadings to make the report easy to navigate.
  • Use bullet points. Use bullet points to break up long paragraphs and make the report more readable.

By following these steps, you can create a well-organized technical report that is easy to understand.

Step 4: Write the Report

Once you have gathered and analyzed all the necessary information, it's time to start writing your technical report. This is where you will combine all the research and data you have collected and present it clearly and concisely.

To begin, start with the introduction. In this section, you should provide some background information on the topic and clearly state the purpose and objectives of your report. Next, move on to the body of the report, where you will present your findings and analysis in detail. Use clear and concise language, and break up large blocks of text with headings and subheadings for easier reading.

Finally, end with a conclusion that summarizes your findings and provides recommendations or suggestions for future research or action.

Step 5: Review and Revise the Report

After you have written your technical report, reviewing and revising it carefully is important. This step ensures that your report is clear, concise, and error-free, making it easier for your audience to understand and follow.

Reviewing and revising your report ensures that it is accurate, well-organized, and easy to read. It also allows you to catch any errors or inconsistencies that may have been missed during the writing process. By taking the time to review and revise your report, you can improve the quality of your work and increase the chances of it being well-received by your audience.

To begin, read through your report carefully and look for any errors in grammar, spelling, or punctuation. Next, ensure that your report is well-organized and easy to follow by checking that your ideas flow logically and that you have used headings and subheadings to break up large blocks of text.

Finally, consider having someone else review your report to get a fresh perspective and catch any errors or inconsistencies you may have missed. This could be a classmate, friend, or even a tutor from CW assignments. CW assignments can do your STEM projects and activities, including technical report writing. Their online lessons and simple math and science-building prep can help you produce the best virtual projects, even in space!

Following these five steps and reviewing your work carefully, you can write a successful technical report that effectively communicates your research and analysis to your intended audience.

Related Articles

Top 5 Steps to Take Ensuring Software Cyber Security

Top 5 Steps to Take Ensuring Software Cyber Security

  • May 05, 2022

Software RFP Template: A Step-by-Step Guide to Avoiding Costly Mistakes

Software RFP Template: A Step-by-Step Guide to Avoiding Costly Mistakes

  • September 22, 2023

Cloud Capacity Planning: A Practical Guide

Cloud Capacity Planning: A Practical Guide

  • November 13, 2023

How to Improve the Security of Your Website in 5 Easy Steps

How to Improve the Security of Your Website in 5 Easy Steps

  • May 05, 2020

How to Use Free Essay Writing Software

How to Use Free Essay Writing Software

  • May 17, 2022

From Novice to Ninja: Programming Tips for Rapid Improvement

From Novice to Ninja: Programming Tips for Rapid Improvement

  • November 05, 2023

Advertising

Free Digital Ocean Credit

All Rights Reserved © 2015 - 2024

Library homepage

  • school Campus Bookshelves
  • menu_book Bookshelves
  • perm_media Learning Objects
  • login Login
  • how_to_reg Request Instructor Account
  • hub Instructor Commons

Margin Size

  • Download Page (PDF)
  • Download Full Book (PDF)
  • Periodic Table
  • Physics Constants
  • Scientific Calculator
  • Reference & Cite
  • Tools expand_more
  • Readability

selected template will load here

This action is not available.

Humanities LibreTexts

Chapter 1: Introduction to Technical and Report Writing

  • Last updated
  • Save as PDF
  • Page ID 179209

\( \newcommand{\vecs}[1]{\overset { \scriptstyle \rightharpoonup} {\mathbf{#1}} } \)

\( \newcommand{\vecd}[1]{\overset{-\!-\!\rightharpoonup}{\vphantom{a}\smash {#1}}} \)

\( \newcommand{\id}{\mathrm{id}}\) \( \newcommand{\Span}{\mathrm{span}}\)

( \newcommand{\kernel}{\mathrm{null}\,}\) \( \newcommand{\range}{\mathrm{range}\,}\)

\( \newcommand{\RealPart}{\mathrm{Re}}\) \( \newcommand{\ImaginaryPart}{\mathrm{Im}}\)

\( \newcommand{\Argument}{\mathrm{Arg}}\) \( \newcommand{\norm}[1]{\| #1 \|}\)

\( \newcommand{\inner}[2]{\langle #1, #2 \rangle}\)

\( \newcommand{\Span}{\mathrm{span}}\)

\( \newcommand{\id}{\mathrm{id}}\)

\( \newcommand{\kernel}{\mathrm{null}\,}\)

\( \newcommand{\range}{\mathrm{range}\,}\)

\( \newcommand{\RealPart}{\mathrm{Re}}\)

\( \newcommand{\ImaginaryPart}{\mathrm{Im}}\)

\( \newcommand{\Argument}{\mathrm{Arg}}\)

\( \newcommand{\norm}[1]{\| #1 \|}\)

\( \newcommand{\Span}{\mathrm{span}}\) \( \newcommand{\AA}{\unicode[.8,0]{x212B}}\)

\( \newcommand{\vectorA}[1]{\vec{#1}}      % arrow\)

\( \newcommand{\vectorAt}[1]{\vec{\text{#1}}}      % arrow\)

\( \newcommand{\vectorB}[1]{\overset { \scriptstyle \rightharpoonup} {\mathbf{#1}} } \)

\( \newcommand{\vectorC}[1]{\textbf{#1}} \)

\( \newcommand{\vectorD}[1]{\overrightarrow{#1}} \)

\( \newcommand{\vectorDt}[1]{\overrightarrow{\text{#1}}} \)

\( \newcommand{\vectE}[1]{\overset{-\!-\!\rightharpoonup}{\vphantom{a}\smash{\mathbf {#1}}}} \)

Bay College

Learning Objectives

What is Technical Writing? [1]

You’re probably wondering what this “technical writing thing” is. Someone may even have told you, “It’s this course where they make you write about rocket science and brain surgery.” Well, not really, as you will see in a moment. Actually, the field of technical communication is essential in a wide range of fields and occupations. It is a fully professional field with degree programs, certifications, and—yes!—even theory. It’s a good field with a lot of growth and income potential; and an introductory technical-writing course for which this book has been developed is a good way to start if you are interested in a career in this field .

Technical writing is an audience-centered means of communication that provides a reader with clear and easy access to information. In the business world, time equates to profit, and profit is the force behind all business interaction. The technical writer and reader have a vis-à-vis relationship. The writer recognizes, respects, and addresses the importance of time in effective and efficient communication by providing documents written in specific formats, using unambiguous language to send clearly accessible information. The reader in turn thoroughly understands the information in order to give a thoughtful response.

The Meaning of “Technical”

Technical communication—or technical writing, as the course is often called—is not writing about a specific technical topic such as computers, but about any technical topic. The term “technical” refers to knowledge that is not widespread, that is more the territory of experts and specialists. Whatever your major is, you are developing an expertise—you are becoming a specialist in a particular technical area. And whenever you try to write or say anything about your field, you are engaged in technical communication .

Academic Writing Versus Technical Writing

The definite purpose, strict format and use of appropriate language in technical writing define the differences between technical writing and academic writing. The academic writer’s purpose may be to write an assignment, a story, a letter, etc.. These works may or may not have a reader. However, technical writing always has a definite purpose and will always have a reader. Regardless of the number of the intended readers of a document who may or may not read the document, the document will be read by the primary reader.

Workplace Writing

However, the focus for technical-writing courses is not necessarily a career as a technical writer but an introduction to the kinds of writing skills you need in practically any technically oriented professional job. No matter what sort of professional work you do, you’re likely to do lots of writing—and much of it technical in nature. The more you know about some basic technical-writing skills, which are covered in this guide and in technical-writing courses, the better job of writing you’re likely to do. And that will be good for the projects you work on, for the organizations you work in, and—most of all—good for you and your career .

Really Technical Writing

Keep relaxing, but you should know that professional technical writers do in fact write about very technical stuff—information that they cannot begin to master unless they go back for a Ph.D. But wait a minute! The technical documents have to ship with the product in less than nine months! How do they manage? Professional technical writers rely on these strategies to ensure the technical accuracy of their work:

  • Study of books, articles, reports, websites related to the product
  • Product specifications: what the product is supposed to do, how it is designed
  • Interviews with subject matter experts: the product specialists, developers, engineers
  • Product meetings during the development cycle
  • Live demonstrations of the product
  • Familiarization with similar, competing products
  • Experimenting with working models of the product
  • Most importantly, subject matter experts’ review of technical writers’ work for technical accuracy and completeness

Of course, experienced technical writers will tell you that product development moves so fast that specifications are not always possible and that working models of the product are rarely available. That’s why the subject matter experts’ review is often the most important.

Considerations of Technical Documents

There are key components of what makes a document strong. Therefore, writers keep these items in mind while constructing technical documents.

The Importance of Audience

Another key part of the definition of technical communication is the receiver of the information—the audience. Technical communication is the delivery of technical information to readers (or listeners or viewers) in a manner that is adapted to their needs, level of understanding, and background. In fact, this audience element is so important that it is one of the cornerstones of this course: you are challenged to write about highly technical subjects but in a way that a beginner—a nonspecialist—could understand. This ability to “translate” technical information to non-specialists is a key skill to any technical communicator. In a world of rapid technological development, people are constantly falling behind and becoming technological illiterates. Technology companies are constantly struggling to find effective ways to help customers or potential customers understand the advantages or the operation of their new products .

Not only is the the level at which you write important but so are the language choices you make as you do so. Please review the information on the following link for tips: Use Language that is Sensitive to Your Audience [2]

So relax! You don’t have to write about computers or rocket science—write about the area of technical specialization you know or are learning about. Also, plan to write about it in such a way that even Grandad can understand !

Formatting and Language

Formatting and appropriate language are the basic design elements of all technical documents. A format that shows a hierarchical structure and a coordinate structure of information le ads the reader thorough text.

Textbook image

Readers should be able to identify a writer’s organizational pattern very quickly when reading a technical document . This sometimes refers to a document being “reader friendly.” In addition , using appropriate language is significant in providing the reader with a thorough understanding of the purpose of the document, how the document relates to the reader’s needs, and what action is expected of the reader. [3]

A document may also have one reader (the primary reader) or several readers (the secondary readers). A primary reader is the person who ordered the report to be written or the person for whom a report is intended. These readers will usually read the entire report. Secondary readers are those readers who will read only the sections of the report that relate to them, their jobs, their departments, responsibilities, etc. For example, if a report was sent that detailed funding for different departments, a piping superintendent may only want to read the section that relates to piping. This is where format, the use of headings, is significant in allowing the reader easy access to information. When the piping superintendent can scan through the document and clearly find the heading that identifies his department saves time.

Cultural Communication

Technical writers need to be aware of the differences between the behavior and the norms, beliefs and values of specific cultural. According to Edward T. Hall and Mildred Reed Hall, In Understanding Cultural Differences, each culture operates according to its own rules (1990, pp. 3-4). Hall and Hall add that problems occur when members of one culture apply the rules to another culture (1990, pp. 3-4). To communicate effectively with other cultures, the technical writer needs to not only be aware of rules governing behaviors that can be observed but also of the not-so-obvious rules that govern the norms, beliefs, and values of the people of a culture. The invisible rules of a culture dramatically impact the acceptance of ideas, plans, and strategies. The Cultural Iceberg illustrates patterns of world communication, showing indicators of Institutional Culture (the obvious behavior of a culture), which can be clearly seen as the tip of the iceberg, and People Culture (the norms, beliefs and values of a culture), which cannot be seen and which are the barriers to successful communication .

Figure 2 The Cultural Iceberg

assignment for technical report writing

Technical writers have a responsibility to their readers and to their employers to follow ethics when writing reports.

Law and Ethics Text with Watch

Technical writers must use words that demonstrate valid appeals to reason, avoiding emotional words and phrases that appea l to basic emotion instead of justifiable reasoning. In addition, technical writers must use valid references to support ideas and strategies, avoiding referencing non experts to sway readers’ support. Also, technical writers must use accurate numbers to report data, avoiding charts and tables that skew data. Using any type of fallacies in technical writing is unethical and could result in dire consequences.

Not only do technical writers have a responsibility to report accurate information, but they also have a responsibility to credit accurate sources of information. At no time is it acceptable to rearrange information in order to attempt to indicate that the writer is the source of someone else’s idea or to indicate that the writer read a report that included information he/she cited, when the primary source of the information was cited in another report. All sources must be referenced accurately in the text and cited on a reference page.

Daniel G. Riordan (2005), in Technical Report Writing Today, cites Dombrowski to define three threads of ethics:

One major thread is that the communicator must be a good person who cares for the audience. Communicators must tell the truth as convincingly as possible, because truth will lead to the good of the audience. Another thread is that the communicator must do what is right, regardless of possible outcomes. A third thread is that communicators must act for the greatest good for the greatest number of people (p. 16) .

In addition, Riordan (2005) references the “code of ethics of the Society for Technical Writers, and cites five of the code’s tenants:

My commitment to professional excellence and ethical behaviors means that I will …

  • Use language and visuals with precision.
  • Prefer simple direct expression of ideas.
  • Satisfy the audience’s need for information, not my own need for self-expression.
  • Hold myself responsible for how well my audience understands my message.
  • Report the work of colleagues, knowing that a communication problem may have more than one solution (Riordan, 2005, pp. 15-16) .

Hall, E. T. & Hall, M. R. (1990). Understanding Cultural Differences. Yardmouth: Intercultural Press, Inc.

Riordan, D. G. (2005). Technical Report Writing Today. Boston: Houghton Mifflin Company.

Visuals & Readability

To make a document more reader friendly, many technical writers rely on visuals to achieve this goal. [5] For example , la bels, callouts and captions are identifying text for graphics . Labels and callouts identify specific elements or features on a graphic; whereas captions are short phrases or sentences that describe the graphic. Notes, or footnotes, explain, or give credit.

Labels and Callouts

To identify specific elements or features, labels and captions are placed directly on the graphic or near it. “Although the terms are used interchangeably, labels are text identifiers that are self-explanatory in an image, while callouts are labels that require further information outside the image to explain what they are identifying” (Gurak 304). They supplement the visual information. But use them selectively; use them only if readers need them (Rude 116).

The advantage of labels is that the reader gains a basic understanding of elements in the graphic without referring to supplementary explanations. But, too many labels obscure the image. In this case, callouts are the better option. Use numbers or letters to identify each element and the supplementary explanations.

Guidelines for Creating Labels and Callouts

  • Determine the number of items to identify in the image (Gurak 308).
  • Estimate how much explanation each item requires to determine if labels or callouts are more appropriate (Gurak 308).
  • create a consistent visual style (Gurak 308)
  • use the same terms on the label or callout as in the text (Rude 116)
  • in general, all parts mentioned in the text should have a label or callout, and all parts with a label or callout should be mentioned in the text. (Rude 116)
  • Use a standard font and size for readability (Rude 116)
  • Align the labels and callouts for a neater appearance (Rude 116)
  • If callouts are used, place the explanatory text in a key next to the graphic.

Labels can take different forms (Gurak 304 – 306):

  • They may be placed directly on the graphic (whereby they become part of the graphic).
  • They may be placed around the graphic and use lines to point to the relevant element in the graphic.
  • Online, labels can be links or hotspots whereby more information about the element is displayed on mouse rollover.

This is an example of l abels placed directly on the graphic.

Map of Central Park with labelled streets and park areas.

Figure 3 Map of the West Side Central Park, NYC between 102nd and 110th Streets.

Here, the labels are placed around the graphic.

Drawing of a flower with all parts labelled with lines to their placement on the drawing.

Figure 4 Parts of a flower.

In this sample, when the mouse is rolled over the ‘Firebox’ label, the text will read: “Literally a box containing the fire. It is surrounded by water on the top and all sides. The bottom is a grate with an ash pan below that.” Additional information is displayed .

Anatomy of a steam locomotive. Each part of the train is labelled with a line to the part.

Figure 5 Labels as hotspots.

Callouts are best used when many parts of the image need to be labeled and each part requires a longer explanation. In fact, the label sequence may be in alphabetical or numerical (as in Figure 6) order. Ensure that the explanation is near the graphic.

Sample Nutrition Facts label from Macaroni and Cheese. Call outs on the left side point to different parts of the label, such as Start Here, Check Calories, Limit these Nutrients, Get Enough of these Nutrients, Footnote, and the Serving Size.

Figure 6. How to understand and use the Nutrition Facts Label.

Coded callouts are in numerical sequence; the explanation for each number appears below the graphic. The example above shows part of the explanation of Number 1 explanation only.

Captions, table, and graphics titles must clearly identify information to the reader. Interpretive captions usually require one or more sentences. Captions should be informational, without becoming too lengthy. Captions that are merely a title for a graphic are not very helpful (Franklin 96).

Writing Style for Captions

  • Captions for graphics include the title and any explanatory material, immediately under the graphic.
  • Words such as Figure, Illustration, and Table should be in bold type.
  • The caption should be italicized.
  • Treat tables and figures the same.

Good captions are what guide readers not only to see, but also to understand. Captions label graphics with titles and explain to readers what they are seeing, and how to interpret the information captured in the visual. The Franklin Covey Style Guide for Business and Technical Communication provides an excellent source for writing captions (Franklin 39 – 41).

Five Specific Style Rules

  • Use interpretive captions whenever possible. I nterpretive captions provide both a title and explanatory information, usually expressed in a complete sentence, to help readers understand the central point(s) that the writer wants to convey. A graphic and its caption should be clear and understandable without requiring readers to search for clarifying information in the text:
  • Figure 4. Cabin-Temperature Control System. Constant cabin temperature control is maintained by the system’s modulated cabin sensor.
  • This interpretive caption gives the title and then tells the reader the principle message – that the check valve provides near-zero risk. And, it states how the check valve provides near-zero risk (Franklin 39).
  • Figure 23. Check Valve . The risk of bad air entering the changer is near zero because the check valve permits air flow in one direction only.
  • This interpretive caption gives the title of the figure and emphasizes that the cabin has a constant temperature – a benefit provided by the feature described in the figure. The caption states clearly what the writer wants the reader to learn from the drawing (Franklin 39).
  • Avoid using short, often ambiguous, titles to replace interpretive captions. In the past, styles for technical and scientific documents used only short, simple title captions for visuals. These were often superfluous, providing no real information other than the obvious to the reader, i.e. – A Horse. Titles that are so short and cryptic that they sound telegraphic are not useful. Such captions are only useful when the graphics are self-explanatory, and require no interpretation (Franklin 40).
  • Number figures and tables sequentially throughout the document, and place the number before the caption. If an important figure or table is presented twice, treat it as two separate visuals and number each. Figure and table numbers should be whole numbers (Franklin 40).
  • Captions may appear below or above a visual, but consistency throughout a document is critical. Arguments support both options; choose one, warrant your choice, and be consistent.
  • Put the caption above the visual for better visibility when captions are used with slides and other project visual aids. Captions placed at the bottom may be blocked by the heads of those seated in front (Franklin 99).

Notes or footnotes are categorized as either explanatory or source notes. Explanatory footnotes are identified by a superscript number or letter. The order in which notes appear is important; explanatory footnotes are placed above source notes. And both are placed above the caption, if the caption is placed at the bottom of the illustration.

A pie chart about Toxic Chemical Releases. Below the chart, a footnote is listed with a source note and caption.

Figure 7. Placement of footnote, source note and caption.

Source: Rude, p. 115, modified.

The Writing Process [6]

Writing, especially when compiling a larger document, is not something you sit down, complete in one session, and quickly submit. This is especially true when writing for the workplace where accuracy and clarity are necessary. In fact, writing should be seen as a process that is recursive where the writer moves in and out of various stages of writing and often times revisits some of the stages. The writing process might consist of the following:

This is the planning done before writing a document. It may be defining the purpose of the task, analyzing the primary and secondary readers, sketching the document and what will go in each section, or gathering research.

This is writing and compiling a first draft of the document. Sometimes, the writer worries more about getting ideas down more than guaranteeing every punctuation or grammar choice is correct.

When a writer revises, a writer revisits the draft and makes substantial changes to it. This is more than editing. It is adding, deleting, and moving entire sections of the document around to prepare it as a final, comprehensive document. In fact, it is here that many writers ask others for feedback before revising to ensure that another, unbiased set of eyes have looked over the document and easily understand it.

This is the final part of the process. It is reading through the document several times while looking for clarity, consistency, and accuracy. In fact, consider reading your document aloud and listening to it as you do so instead of reading and “seeing” it. Most individuals communicate mostly through talking and listening. Therefore, when you read aloud, you can hear if something in your document doesn’t sound right and then correct it. You should be able to read it in a way that it is understandable and sounds conversational.

For additional information on the writing process, visit The Writing Center website for the University of Texas: University of Texas Writing Center & The Writing Process .

Using a process in the workplace and in our class will strengthen your documents significantly. In fact, remember that your documents reflect on who you are as student, technical writer, employee, and even researcher.

[1] Technical Writing. Authored by : Dr. Elizabeth Lohman. Provided by : Tidewater Community College. Located at : http://www.tcc.edu/ . Project : Z Degree Program. License : CC BY: Attribution , edited by Amber Kinonen , edits included in italics

[2] Use Language that is Sensitive to Your Audience. Provided by : Writing Commons. Located at : http://writingcommons.org/open-text/collaboration/143-common-comments/word-choice-/575-use-language-that-is-sensitive-to-your-audience . License : CC BY-NC-ND: Attribution-NonCommercial-NoDerivatives edited by Amber Kinonen , edits included in italics

[3] Image of Textbook. Authored by : Dominik Wagner. Located at : https://flic.kr/p/eoAvCb . License : CC BY: Attribution

[4] Image of Text with Watch. Authored by : Stephen Wu. Located at : https://flic.kr/p/tZ1LP . License : CC BY-NC-ND: Attribution-NonCommercial-NoDerivatives

[5] Norbert Elliot’s “Labels, Callouts, Captions and Notes” CC-BY Saylor, edited by Amber Kinonen , edits included in italics

[6] The Writing Process CC-BY Amber Kinonen

Icon for the Creative Commons Attribution 4.0 International License

Chapter 1: Introduction to Technical and Report Writing by Bay College is licensed under a Creative Commons Attribution 4.0 International License , except where otherwise noted.

Dr. Bill Williamson | Professor of Technical Communication | SVSU

Rpw 304 technical report writing.

Labs + Projects

About Dr. Bill

Course Links

Assignments

This page provides an overview of the work that contributes to your final course grade, and connects you to descriptions for those projects and workshops through the links below. (Note that no descriptive detail appears on SVSU Canvas for any of these assignments.) I activate assignment pages as we need them , so do not worry if you cannot access all of the descriptions at the beginning of the semester.

Your course grade is computed from the points you earn on 2 projects and 9 workshops . Combined, these assignments total 1300 possible points .

You can read more about grading and what factors might influence your grade on the Policies page.

I use the term projects to categorize assignments that are significant undertakings that require development and refinement time that may span several weeks of the semester. You will complete 2 projects this semester that collectively contribute 800 possible points to your course grade .

Both projects connect to the same core topic, which itself ties to the challenge of communicating professionally relevant knowledge. You will identify a topic of study no later than the end of week two. Because I emphasize communicating from a position of expertise in this course, you must identify a topic of study with which you have expertise, and that is in some way relevant to your professional development or career objectives. This expectation will make more sense as we go. The selection of an appropriate focus for your work is a topic of early emphasis in the course.

Each project description details several elements of the work, including design requirements, hints and tips, and submission guidelines. Use the links below to access those descriptions.

  • Neutral, objective examination of an object of study (OoS).
  • Disciplined, data-driven evaluation of the same OoS.
  • Experience-based insight into the design and function of the OoS.
  • Design Pitch (DP) . 200 points. The DP results in a 7 to 10 minute screencast video that presents your proposal for a design that improves upon or replaces your chosen object of study (OoS). The DP project is challenging because it requires you to distill knowledge gained from observation, experience, and research to support a concretely detailed description for a new or improved product design.

I use the term workshops to categorize assignments that are smaller scale than projects, work that can be completed in the space of a single class session, or within the space of a single class week. The concepts, strategies, and practices examined through workshops build and reinforce your working knowledge for the course. You will complete 9 workshops this semester that collectively contribute 500 possible points to your course grade .

Each workshop description details several elements of the work, including design and discussion requirements, and submission guidelines. Use the links below to access those descriptions.

  • Document Design . 50 points. Using Microsoft Word , you design a 1-page profile that discusses your professional development interests, and your experience with information design.
  • Artifact Analysis . 50 points. We examine the practice of artifact analysis in preparation for work on the Design Assessment project.
  • Screencast Design . 50 points. Using Techsmith Capture and the Screencast.com streaming service, you create and share a screencast focused on the profile document you created during the Document Design workshop.
  • Heuristic Analysis . 50 points. We examine the practice of heuristic analysis in preparation for work on the Design Assessment project. Your ultimate goal is to understand the HA process well enough to conduct your own study of the OoS you select this semester.
  • UX Scenario . 50 points. We examine the practice of scenario-driven think-aloud protocol in preparation for work on the Design Assessment project. Your ultimate goal is to understand this UX process well enough to conduct your own study of the OoS you select this semester.
  • UX Scenario Design . 50 points. You construct a set of UX scenarios that you can use to study the OoS you have selected for your work this semester.
  • Editing 1 . 50 points. This workshop provides an opportunity to apply strategies for document-level editing to a working document.
  • Editing 2 . 50 points. This workshop provides an opportunity to apply strategies for sentence-level editing to a working document.
  • Peer Review: Design Assessment . 100 points. You prepare for and engage in peer examination of your Design Assessment project draft, and participate in the review of two peer projects.

Purdue Online Writing Lab Purdue OWL® College of Liberal Arts

Welcome to the Purdue Online Writing Lab

OWL logo

Welcome to the Purdue OWL

This page is brought to you by the OWL at Purdue University. When printing this page, you must include the entire legal notice.

Copyright ©1995-2018 by The Writing Lab & The OWL at Purdue and Purdue University. All rights reserved. This material may not be published, reproduced, broadcast, rewritten, or redistributed without permission. Use of this site constitutes acceptance of our terms and conditions of fair use.

The Online Writing Lab at Purdue University houses writing resources and instructional material, and we provide these as a free service of the Writing Lab at Purdue. Students, members of the community, and users worldwide will find information to assist with many writing projects. Teachers and trainers may use this material for in-class and out-of-class instruction.

The Purdue On-Campus Writing Lab and Purdue Online Writing Lab assist clients in their development as writers—no matter what their skill level—with on-campus consultations, online participation, and community engagement. The Purdue Writing Lab serves the Purdue, West Lafayette, campus and coordinates with local literacy initiatives. The Purdue OWL offers global support through online reference materials and services.

A Message From the Assistant Director of Content Development 

The Purdue OWL® is committed to supporting  students, instructors, and writers by offering a wide range of resources that are developed and revised with them in mind. To do this, the OWL team is always exploring possibilties for a better design, allowing accessibility and user experience to guide our process. As the OWL undergoes some changes, we welcome your feedback and suggestions by email at any time.

Please don't hesitate to contact us via our contact page  if you have any questions or comments.

All the best,

Social Media

Facebook twitter.

assignment for technical report writing

6 ways to use Microsoft Copilot for end-of-school-year tasks

May 14, 2024.

By Microsoft Education Team

assignment for technical report writing

Share this article

The end of the school year is a hectic time for educators everywhere. Between reviewing content, completing assessments, and maintaining classroom management, it’s easy to feel the pressure of too many responsibilities and not enough time to accomplish everything.

Whether closing out the academic year in the northern hemisphere or preparing for the next one in the southern hemisphere, Microsoft Copilot offers innovative and efficient ways to complete many of the tasks that occupy these transitional times of year. From drafting student feedback to composing newsletters and offering planning suggestions for events, Copilot adapts to whatever task it’s asked. To get started, all you need is a basic understanding of how to access and use Copilot.

Start using Copilot for your end-of-school-year tasks

You can learn how to use Copilot by visiting Meet your AI assistant for education: Microsoft Copilot .

When you’re ready to get started, go to copilot.microsoft.com or download the iOS or Android mobile app.

Writing prompts for the end of the school year

Prompting Copilot to generate content requires practice. Including specific information in your prompt helps produce more relevant responses.

An effective Copilot prompt:

  • Asks the tool to take on a role called a persona .
  • Provides an objective  that tells the tool what to do or produce.
  • Defines the audience  who will be using whatever Copilot generates.
  • Includes context  that gives the tool background information.
  • Sets boundaries  that limit or constrain responses.

assignment for technical report writing

Elements of a Good Prompt infographic which includes tips for writing prompts that produce more relevant responses.

Throughout this post, you’ll find sample prompts that include these components. We recommend borrowing inspiration from them and adjusting to make them fit your own classroom, or you can copy and paste the examples without modifications if you are just beginning.

Now let’s learn how Copilot can help you complete six common end-of-school-year tasks.

1. Craft student feedback at the end of the school year

Copilot can help you write end-of-school-year feedback in a style and tone that all students can understand. Simply craft a prompt that includes the subject area and details about the feedback you want to provide, and Copilot can draft a constructive, supportive statement written specifically for students. For example:

You are a fourth-grade teacher who is writing feedback on a student’s current reading skills. The student uses details to explain what text means but is unable to draw inferences in fiction. The student can identify in-text examples that illustrate a given theme but is unable to independently produce a theme without guidance. Write a short statement that explains this feedback to a student. Include a description about why using details is important and 1-2 ways to develop this skill. The paragraph should be written with plain text so that a fourth-grade student will understand.

You can always refine your prompt if the response is not what you expected. Simply include something like, “Re-write this feedback in Spanish” without selecting New topic , and Copilot will continue where you left off. Give it a try.

2. Write end-of-school-year reflections

Educators often write end-of-school-year newsletters for families, update class blogs with a final post, and draft reflections on school year goals. Copilot can assist with all these tasks and can help you create personalized, engaging visuals for your content. For example, you can use the following prompt to produce a summer newsletter for families.

You are the science department leader for a middle school in New York City. Draft a summer newsletter for families that includes an introduction that talks about the past year and 5 sections: Science Books for Young Adults, Science at Home, Science Summer Camps, Science Events in NYC, and NY Science Museums. Only include information that can be linked to a website to learn more. The newsletter should be written in plain text using an informal tone.

You can also share your experiences, memorable moments, and insights from the school year and Copilot will help you find creative ways to share this information with colleagues, families, and students.

3. Organize classroom materials at the end of the school year

The last few weeks of a school year includes packing up classrooms for the summer, collecting books and devices, and organizing materials for the next year. Copilot can create checklists or reminders for end-of-school-year tasks like these and offer suggestions that you might not even consider. For example:

You are a high school media specialist who checks out technology to administrators and educators. Write a checklist of the 3 most important things to do before returning each of the following devices: document camera, tablet, digital projector, games, and wires. Make each device a section heading and use bulleted lists for the content. Write the checklists so that the content is easily understood by people with varying levels of technological expertise.

Another way to use Copilot when you are organizing classroom materials is to ask for suggestions for efficient ways to declutter and prepare your classroom for the next school year.

4. Plan an end-of-school-year celebration

Many schools celebrate major milestones like the start of summer or moving from lower grades to higher grades with a party or ceremony. Copilot can be your personal planner and assist with brainstorming ideas for end-of-school-year events, awards ceremonies, or virtual gatherings. It can even suggest ways to be more inclusive in areas you might not have considered, like food options in the prompt below.

You are a guidance counselor in charge of helping rising eighth-grade students transition from middle school to high school. Draft a letter to middle school teachers that shares the biggest differences between middle school and high school. Include paragraphs on class schedules, touring the high school, meeting educators, extracurricular activities, and summer reading books. The letter should be written in a formal, conversational tone.

Whether you are creating invitations, planning activities, or drafting speeches, Copilot can be your creative collaborator.

5. Develop transition materials at the end of the school year

When students enter elementary school or move to middle or high school, everyone involved in the transition needs to know how to prepare for this change. Students need to know what to expect, families need to know how to support their children, and current educators need to provide relevant information. Copilot can help create transition materials so that everyone stays informed using a prompt like this example:

You can also use Copilot to write welcome letters, tips for success, or information about what to expect in the upcoming year.

6. Streamline parent communication at the end of the school year

Copilot can help you create templates for parent-teacher conferences at the end of the school year, as well as student progress updates, and letters to families. For example, you can ask Copilot to create a message to families about signing up for conferences with the following prompt.

You are a high school math teacher who teaches introductory algebra. Write a letter to families about parent-teacher conferences. Include an introductory paragraph that thanks families for their ongoing support and paragraphs about what will happen during the conferences, why conferences are important, who should attend, and how to prepare for the meeting. Conclude the letter with a paragraph about how to sign up for a conference slot. Write the letter using an approachable, informal tone.

Microsoft Copilot is a versatile AI tool for educators that adapts to your specific needs. To learn more about Microsoft’s AI solutions and resources, check out Smart learning: AI resources every educator should know and the  AI for educators learning path on Microsoft Learn. Most importantly, enjoy the end of the school year with your students and the time you saved by using Copilot. 

Related stories

assignment for technical report writing

Explore insights from the AI in Education Report

The swift rise of generative AI is reshaping how schools approach creation, problem-solving, learning, and communication. Your schools are in a pivotal moment when critical thinking and metacognitive skills are more important than ever as new technology develops

assignment for technical report writing

How to celebrate Earth Day 2024 with your students

Spark your students' curiosity with Earth Day activities and more from Microsoft. From video games to projects, try these fun Earth Day activities for your class.

assignment for technical report writing

Kickstart your school’s AI journey with the Microsoft Education AI Toolkit

AI is igniting enthusiasm in classrooms, department meetings, board rooms, and administrative offices across the country. For many, generative AI is changing what it means to create, solve problems, communicate, and even learn. It’s not just teachers and students embracing this new technology; education leaders are also turning to AI to improve operational processes and provide equitable access to resources among other opportunities.

  • SCHOOL STORIES
  • MICROSOFT EDUCATOR CENTER
  • CONTACT SALES

IMAGES

  1. Technical Report Writing

    assignment for technical report writing

  2. Technical Report

    assignment for technical report writing

  3. technical report writing rules

    assignment for technical report writing

  4. Mastering Technical Report Writing Skills

    assignment for technical report writing

  5. 50 Professional Technical Report Examples (+Format Samples) ᐅ

    assignment for technical report writing

  6. 26 Best Technical Report Examples, Format, and Templates

    assignment for technical report writing

VIDEO

  1. Technical Report Writing (Lecture 1)

  2. Technical Report Writing 1

  3. TECHNICAL REPORT WRITING PART 1

  4. Review on Effective Writing, Technical Report Writing شرح ومراجعه علي

  5. Technical Report writing (Part 1) [Title page, Summary, Table of Contents, Introduction]

  6. Review on Effective Communication, Technical Report Writing شرح ومراجعه علي

COMMENTS

  1. PDF A guide to technical report writing

    Reports are often written for multiple readers, for example, technical and financial managers. Writing two separate reports would be time-consuming and risk offending people who are not party to all of the information. One solution to this problem is strategic use of appendices (see page 5). A guide to technical report writing - Objectives 04 2.

  2. PDF A guide to technical report writing

    6. Conclusion. The report is checked, its appearance is pleasing, it is easy to handle, 'interesting' and 'readable', to quote the criteria suggested at the beginning of this Guide. If the technical content is as good as the organisation, writing, illustration and finishing, then the report should delight the reader.

  3. PDF A Guide to Writing Formal Technical Reports

    A Guide to Writing Formal Technical Reports: Content, Style, Format. Adapted by Robin L. Potter (2021) from the original document by University of Victoria (n.d.). Engineering Work Term Report Guide: A Guide to Content, Style and Format Requirements for University of Victoria Engineering Students Writing Co-op Work Term Reports.

  4. Guide to Technical Report Writing

    Guide to Technical Report Writing. Table of contents. 1 Introduction. 2 Structure. 3 Presentation. 4 Planning the report. 5 Writing the first draft. 6 Revising the first draft. 7 Diagrams, graphs, tables and mathematics. 8 The report layout. 9 Headings. 10 References to diagrams, graphs, tables and equations. 11 Originality and plagiarism

  5. Chapter 1: Introduction to Technical and Report Writing

    The academic writer's purpose may be to write an assignment, a story, a letter, etc.. These works may or may not have a reader. However, technical writing always has a definite purpose and will always have a reader. ... Daniel G. Riordan (2005), in Technical Report Writing Today, cites Dombrowski to define three threads of ethics:

  6. PDF A guide to writing technical reports

    To generate an automatic TOC, you need to apply heading styles (found under the Home tab) to format appropriate text in the body of the report as a heading. Apply Heading 1 style to each main section (chapter) in the report, and a Heading 2 or 3. style to the various sub-sections within the report. To add the TOC, go to References tab>Table of ...

  7. Simple Ways to Write a Technical Report (with Pictures)

    5. Round out the report with a conclusion that bookends your introduction. In a technical report, your introduction should raise the "big" questions and your conclusion should provide your answers. If, for instance, you listed several specific questions in your intro, answer them specifically in the conclusion.

  8. PDF Guide for writing technical reports and papers

    Guide for writing technical reports and papers a short-list compilation from the best sources by Frank Leferink The motto of scientific writing is brevity and clarity, that is, to provide maximum information with minimum words in a well-organized manner.

  9. CH 7: Technical Reports

    Describes one-time events, such as trips, conferences, seminars, as well as reports from offices and industrial plants. 4. Progress Report. Monitors and controls production, sales, shipping, service, or related business process. 5. Technical Report. Communicates processes and products from a technical perspective. 6.

  10. PDF Guide for Writing Technical Reports

    The majority of engineering tasks include the writing of technical reports, even if the main objective is much more extensive. Since technical reports and papers are used to summarise information in a way that is easily accessible, they should be as concise, accurate and complete as possible, and be aimed at a specific group of readers.

  11. Assignment Design

    Sample 1: Lab Report (as a Technical Report) Writing Assignment. Overview: You (the writer of the report), a 2nd year engineering student, are assigned to write a technical report (the genre) to convey engineering and technical information, including the lab background, process, data, analysis results, and conclusion (the purpose of the report), to the instructor, the TA, and the peers (the ...

  12. Introduction

    The purpose of a technical report is to completely and clearly describe technical work, why it was done, results obtained and implications of those results. ... Although this document provides guidance for good lab report writing, chronicling work performed for a laboratory assignment as is done for the familiar academic lab report is not the ...

  13. CH 7 Assignment: Instructions

    7.4 Technical Reports. 7.5 Report Introductions. 7.6 Progress Reports. ... The main purpose of this assignment is to give you practice in writing instructions, one of the most common types of workplace technical writing. Whether working with office staff, technicians, managers, or executives, technical communicators are frequently called upon ...

  14. 5 Essential Steps to Writing a Technical Report

    The first step in writing a technical report is identifying the purpose and audience. The report's purpose will help you determine what information to include and how to structure the report. ... This could be a classmate, friend, or even a tutor from CW assignments. CW assignments can do your STEM projects and activities, including technical ...

  15. PDF Technical Writing and Presentation

    • The objective of a technical report is to clearly describe technical work, why it was prepared, results obtained and consequences of those results. • The technical report serves as a means of communicating the work to others and possibly providing valuable information about the work. • A well‐written report is about organization. A ...

  16. Chapter 1: Introduction to Technical and Report Writing

    Academic Writing Versus Technical Writing . The definite purpose, strict format and use of appropriate language in technical writing define the differences between technical writing and academic writing. The academic writer's purpose may be to write an assignment, a story, a letter, etc.. These works may or may not have a reader.

  17. Engineering: Technical report

    A sample of a student's Engineering technical report with a teacher's feedback. ... Industrial design assignment; MADA: Visual analysis; Arts. Arts: Reflective writing in Arts ... Business and Economics. BusEco: Reflective essay; BusEco: Essay; BusEco: Writing case studies; BusEco: Report writing; Education. Education: Reflective writing ...

  18. RPW 304 Technical Report Writing

    You will complete 9 workshops this semester that collectively contribute 500 possible points to your course grade. Each workshop description details several elements of the work, including design and discussion requirements, and submission guidelines. Use the links below to access those descriptions. Document Design. 50 points.

  19. Technical Reports Writing Assignment

    TECHNICAL REPORT WRITING Assignment # 01 Submitted To: Engr. M KASHIF ASHRAF Submitted By: USAMA EHSAN Registration No: MEET Institute of Mechanical and Manufacturing Engineering TECHNICAL REPORTS WRITING 1 Introduction. A technical report is a formal report designed to convey technical information in a clear and easily accessible format. It is ...

  20. PDF CIT 702-TECHNICAL REPORT WRITING

    Technical report writing is an essential skill for many situations requiring formal and effective communication of ideas, information, and knowledge. You will learn how to identify, ... Tutor-Marked Assignments are included at the end of appropriate units of the text. Answers to these questions are to be submitted at appropriate times

  21. Assignment, Technical Report Writing and Research Methods

    Assignment, Technical Report Writing and Research Methods - Free download as PDF File (.pdf), Text File (.txt) or read online for free. for year one

  22. Assignment Technical report writing

    Assignment 3 TECHANICAL REPORT WRITING Announced Date: 23-05-2019 Due Date: 10-06-2019 Total Marks = 3 Marks Obtained = Teacher Name: Komal Maheshwari Question No1: Identify the modern tools for technical reports and presenta ons. 1. Visme Visme is a cloud-based presentation tool that allows you to create highly visual presentations to engage ...

  23. Welcome to the Purdue Online Writing Lab

    Mission. The Purdue On-Campus Writing Lab and Purdue Online Writing Lab assist clients in their development as writers—no matter what their skill level—with on-campus consultations, online participation, and community engagement. The Purdue Writing Lab serves the Purdue, West Lafayette, campus and coordinates with local literacy initiatives.

  24. How teachers started using ChatGPT to grade assignments

    A new tool called Writable, which uses ChatGPT to help grade student writing assignments, is being offered widely to teachers in grades 3-12. Why it matters: Teachers have quietly used ChatGPT to grade papers since it first came out — but now schools are sanctioning and encouraging its use. Driving the news: Writable, which is billed as a ...

  25. 6 ways to use Microsoft Copilot for end-of-school-year tasks

    Now let's learn how Copilot can help you complete six common end-of-school-year tasks. 1. Craft student feedback at the end of the school year. Copilot can help you write end-of-school-year feedback in a style and tone that all students can understand. Simply craft a prompt that includes the subject area and details about the feedback you ...