Kevin Boone

How to write a technical or scientific report

Version 2.01, July 2022

Summary

pen

This article gives some general guidelines on writing a technical or scientific report. It describes the 'standard model' of report writing, and some alternatives. The article is intended for students who are currently undertaking undergraduate or master's degree projects, or expect to do so in the near future. However, some parts of it will apply to people who have to write in the course of business, particularly in technology.

When I first wrote this article, back in the mid-90s, most reports and scientific articles were still circulated in printed form. These days, web-based publishing seems to be more commonplace, even for prestigious scientific journals. I've encountered the view that web-based articles are expected to be quick and dirty, and don't have to reach the same standards that print does. I would argue that the opposite is the case -- there is so much material on the web, both reliable and unreliable, that a high standard of clarity and organization is more important than it is for print. There's just too much else for us to read online, to force ourselves to read things that are disorganized or stylistically jarring.

Please note that I'm writing for a British readership. Probably some of what follows will apply in other English-speaking countries, but I can't be sure of that.


Contents

Summary
Contents

1 Introduction

2 Fundamentals

3 The standard model

4 Alternatives to the standard model

5 Language, style and presentation

6 Graphic material

7 Things to avoid

8 General guidelines

Bibliography

1 Introduction

The ability to write clear, concise reports is an asset to almost any professional. In this article I offer some general guidelines on report writing, focusing particularly on something I call the 'standard model'. This standard model is a formalisation of the way that scientific and many technical reports have usually been written over the last seventy years or so. While the standard model has its detractors, and is often used inappropriately, it still has a lot to recommend it. I normally suggest to students who don't have much writing experience that they follow this model unless they have good reasons not to. In this article I will also try to explain why we recommend that reports are written in a particular way.

2 Fundamentals

The main purpose of a scientific or technical report is to convey information. The report should place as few hindrances as possible between the mind of the writer and the mind of the reader. A secondary function is to stimulate and entertain. There are people -- a tiny minority -- who can inform and entertain at the same time. If, like most people, you have to make a choice between the two, you should try to inform rather than to entertain. Of course, if you're writing a novel the priorities are reversed; but in report writing information is paramount.

A good report needs careful planning. As part of the planning stage you should try to answer the following questions.

3 The standard model

The 'standard model' of report writing is a style and structure that has been widely used in the western world for about seventy years. It is the reporting method that is usually taught (often badly) in schools. Contrary to what we are taught in schools, however, it is not the only accepted way to write in science. Nevertheless, it is the way that many professional scientists and engineers choose to write. The main features of a report that follows the 'standard model' are as follows.

Most 'standard model' reports will contain some or all of the following sections, usually in this order. Each of these sections will be discussed in more detail below:

Abstract or summary; Acknowledgements; Introduction; Objectives; Theory; Method (or methodology or procedure); Results; Discussion or interpretation; Conclusions; Recommendations; References and/or bibliography; Appendices.

A standard report, if it is more than a few pages long, will probably also contain a table of contents, a list of abbreviations and technical terms, and perhaps an index if it is very long.

3.1 The abstract or summary

An abstract or summary (these words mean essentially the same thing) should contain a brief overview of the report, including its conclusions and recommendations if there are any. A good length for an abstract is 300 words; may scientific journals specify this number of words explicitly. The abstract of a scientific paper or report should be capable of standing alone, and being published separately. For this reason the heading 'Abstract' in a report is usually not numbered. Numbering usually starts with the introduction, which would be section '1'.

3.2 The introduction

The introduction sets out what the report is about, and what its role is in relation to other work in the field. If describing experiments, the introduction will usually summarise other related experiments, and show how the work to be described extends or supersedes these earlier studies. If the report is about development (e.g., software development) the introduction will often set out what the purpose of the development is, who will benefit, and how it will be used. If the report is a review, it will usually just state the scope of the report and the readership for which it is intended.

In most technical reports, the introduction will say something about the context of the report, that is, how it forms part of the overall body of work in its subject area. When describing an investigation, the introduction will usually state explicitly what the investigators set out to find.

My approach with a scientific paper is to finish the introduction with a list of the questions the project set out to answer, and then to give the answers to these questions in the conclusions. I like to be quite explicit about this, and even label the questions 'question 1', 'question 2', etc. Whether you do this or not, the reader should be able to look at the conclusion of your report and verify that you have indeed found out what you claimed you would find out.

3.3 The objectives

This section, if present, states what the work being reported was expected to achieve, why it was undertaken, and at whose instigation. I usually prefer to put this information at the end of the introduction, but this is just a matter of taste.

3.4 The acknowledgements

It is polite to give a brief note of thanks to those people who have helped directly in the work the report describes. In a novel, the authors often thank their friends and family; many consider it pretentious to do this in a technical report. In my university career I have read technical reports that acknowledged the invaluable assistance of all kinds of people with no clear connection to the writer. Even pets have been thanked.

If the report is destined for formal publication, and describes work supported by grant funding, the grant-awarding body may insist that it be acknowledged. It seems reasonable to me to do this.

It is not uncommon to see acknowledgements at the end of a report, rather than the beginning.

3.5 Theory

The theory section, if used, describes any background theory needed for the reader to understand the report. Such a section is usually found only in reports that use mathematics that the typical reader cannot be expected to know in advance.

If the theory is so extensive that it might have to be studied rather than skimmed, it is more common to place it in an appendix. It's still helpful, in my view, to provide an outline in the body of the report.

3.6 The method/methods/methodology

In the 'method' section you should describe how you carried out the work, what equipment you used, and any particular methodological problems (not personal or financial problems) you had to overcome. If the report is describing a survey -- common in the social sciences -- you should say how you chose your subjects, how you checked for bias, and how you analysed the results. If you use commercial computer software, it is customary to describe who supplied it, even when it is obvious.

3.7 The results

In the standard model, results are usually given as plainly as possible, and without any comment. It is often difficult to know how much data to put into this section. My feeling is that you should include enough data to enable to reader to be confident that you have done what you said you would do, and that your conclusions are trustworthy. This certainly does not mean that you should include reams of print-outs and copies of questionnaire returns. I try to summarise the results into a few tables and graphs.

If you really need to include a large volume of results -- and sometimes a conclusion will not be defensible without doing this -- then it might be more useful to place them in an appendix, and include only a summary in the main text.

Most readers who are used to reading scientific reports will become uncomfortable if you call a section 'results' and put anything in it apart from plain, uninterpreted results.

3.8 The discussion

In this section the author provides an interpretation of the results, compares them with other published findings -- if there are any -- and points out any potential shortcomings in the work.

The 'discussion' section of a traditional report is the place where the author is prepared to be less objective than elsewhere. In this section it is acceptable to mention opinions, and speculate about the significance of the work.

In particular, if your findings are unusual, or very much at odds with other people's findings, you should explain why this might be, else the reader will probably assume you just made a mistake.

3.9 The conclusion

The conclusion gives the overall findings of the study. It is important to realise that 'conclusion' does not just mean 'the last bit of the report'. Your conclusions should really be statements that can be concluded from the rest of the work. A conclusion is not a summary (you can include a summary as well, if you like). When I examine students' reports, one of the questions I ask is: do the conclusions follow from the body of the report?

3.10 The recommendations

In this section the author normally includes any advice he or she wishes to offer the reader. If the report is about making some sort of business decision, the appropriate course of action will usually be recommended here. Some people use the recommendations sections for suggestions of further work, which seems reasonable to me.

3.11 The references and bibliography

The purpose of citing references is to allow the reader to follow up your work, and perhaps check that the conclusions you draw really follow from the sources you cite. References are not, as many students appear to think, a method for convincing the examiner that you have read a lot. You should give enough detail that if the reader wanted to follow up your references, he or she would be able to do so. For books, we conventionally give the authors, year, edition (if there's more than one), publisher's name and publisher's location. In reality, an ISBN number is sufficient for a book to be located. For articles in journals give the authors, year, name of the publication, volume and page numbers. If you can't give all these details, you probably don't have a proper reference.

The rise in web-based publishing has created its own citation problems. The same basic principle applies, however, as it does to citing printed works: the citation must be sufficient to allow the reader to follow up the reference. If possible, you should cite a URL that will take the reader directly to the document you cite. Giving the URL for a 'home' or 'welcome' page is generally not helpful. As a matter of good style, you should give the names of the authors and the publication date, if you are able to determine them.

Although it is not peculiar to web-based publication, authors should be aware of the problem that not all references have equal weight. References to articles in peer-reviewed journals will be more convincing than references to non-reviewed sources, particularly self-published ones. Since anyone can publish anything on a web site, there is a real risk of citing something that is not authoritative. It's worth pointing out that, in academic circles, references to Wikipedia and similar sites, although often invaluable for research, usually have absolutely no referential status whatsoever.

Many students seem not to know the difference between 'references' and 'bibliography'. The bibliography is the set of publications to which the authors referred in a general sense in writing the report or carrying out the work it describes. These publications will not usually be cited explicitly in the text. References, on the other hand, are given in support of some specific assertion, and are always mentioned explicitly in the text. Normally the citation is given after the statement the author wants to support. A common method is to give the authors and year in the text, e.g, (Bloggs, 1995), and the full details at the end of the report or in a footnote.

In scientific writing, if you make any statement that is not one of plain fact or measurement, you must justify it, or refer the reader to another publication where it is justified. The making of unjustified assertions is probably the single most common criticism leveled at students' writing.

If you use another person's words directly, you must be clear about this and give a full reference. If you use more than a few words, or a picture, or experimental results, you should seek the author's permission first, and state in your report that you obtained such permission. If you don't do this you're potentially breaking the law, as well as being unprofessional.

3.12 The Appendices

The appendices are where the author will usually place any material that is not directly relevant to the report, and will only be read by small number of people. I usually use appendices for mathematical proofs, electrical circuit diagrams and sections of computer programs.

3.13 Numbering and structure

It is common to number each section of the report. Usually numbering starts at the introduction, which has number '1', and continues until the references. Because they are in a sense independent of the body of the report, the abstract and references are not usually numbered. Most people number sub-sections as well. So, for example, section one, sub-section two would be numbered '1.2'. Other people prefer to use numbers and letters, e.g., 1A, 1B..., which is also fine. The advantage of using a hierarchical numbering scheme is that it helps to orient the reader, allowing the most important section divisions to be identified at a glance.

3.14 When should you use the standard model?

In my opinion, writers of technical reports should use the standard model, or something close to it, unless there is a sound reason not to. Why? First, and most important, its use is so widespread that the reader will know exactly what to expect in each section. Moreover, if the reader needs to refer to your report quickly he or she will know immediately which section to turn to. Second, it is well signposted; even people who are not familiar with this type of report will find the clear section divisions useful. Third, the rigid organisation of the report will help the novice writer organise his or her thoughts when writing.

There are times when the standard model will be a hindrance, rather than a help. In these cases you should cheerfully abandon it. In particular, you won't always need to include all the sections. A 'results' section, for example, is only useful if you are reporting results or measurements.

4 Alternatives to the standard model

Here are a few suggestions of other ways to organise a technical report, all of which I've seen used successfully.

4.1 The segmented standard model

If a report describes a set of investigations with a common purpose, but different methodologies, it can be rather difficult to use the standard model, even if each individual investigation could be reported that way. In this case it is useful to give each experiment its own 'segment' with a method and results section, but single overall introduction and discussion. In the segments, you do not necessarily need to use explicit sub-sections for method and results, as long as the reader is clear where the boundaries are.

4.2 The assertion model

This is quite unusual in a report, but often used in presentations. It can be very effective when used appropriately. In this type of report, rather than using very passive section titles like 'Introduction', the author uses active, direct headings, like 'New protocol improves communications efficiency by 23%'. The headings together make up a summary of the report. Of course, if you make an assertion you then have to go on to defend it, and that defence will form the body of each section. The great advantage of this type of presentation is that the reader can get an overall idea what the report says simply by scanning the headings. It is a valid criticism of the standard model that the reader can't extract any information merely by skimming the headings, as they are generic.

4.3 The conclusion first model

In this type of report, the conclusions are presented towards the beginning, perhaps directly after the introduction. In my opinion one should re-state or summarise the conclusions at the end as well, otherwise the report ends abruptly. The advantage of placing the conclusion at the beginning is that it is more likely to be read. It also allows the reader to have the conclusions in mind while reading the rest of the report. I don't use this method myself; I prefer to put a short summary of the conclusions in the abstract.

4.4 The topic model

In this type of report, each section of the report is on a particular topic or subject, but there will probably be a common introduction and conclusion. This structure is appropriate for review or instructional articles, but is probably not very useful for scientific reports. The problem is that it does not lend itself to the clear divisions between methodology, results and interpretation that most readers will expect.

5 Language, style and presentation

If your message is one of profound importance, it will be communicated rapidly even if you present it badly. On the whole, however, few scientific and technical reports contain ground-breaking findings. Consequently the author must pay attention to issues of communication, to encourage people to read the report.

5.1 Grammar and spelling

Most academics and scientists, and many businesspeople, are relatively fussy about grammar and spelling. This is probably because such people read a great deal, and have learned to extract as much information from a document as possible in a limited time. This is only possible if everyone follows very similar standards of grammar and spelling. Whatever the reason, the only way the author can be sure that no reader will be alienated by inadequate grammar and spelling is to ensure that they are impeccable.

If your grammar and spelling are not particularly good, it is vital that you have your work read by someone else before you decide that it's finished (I think that everyone should do this anyway). At the very least you should get a printed copy of your document (not on a computer screen) and check it very thoroughly yourself. However many of us, including me, have become adept at skimming over our own errors.

Most readers won't care whether you use British or American spelling and word choices -- increasingly we are unable to tell the difference, anyway. However, many people have a sharp eye for inconsistency -- if you write 'color' in one line, and 'colour' in the next, it might diminish your credibility.

5.2 Style

Most technical documents are written in a rather formal style. Some readers get upset when they have to read reports that are written informally, but I don't mind this. However, what does annoy me as a reader is sudden changes from formal to informal writing -- it gives the impression that the writing was haphazard.

In the UK, technical writing is usually dominated by 'passive voice' expressions, where the author tries to avoid using the word 'I'. Personally, I am inclined to use the word 'I' whenever I think it is appropriate to do so. If you prefer not to, that's fine. However, you should avoid writing very ugly phrases just to avoid the word 'I'. For example, a phrase commonly used in scientific articles is 'It is the opinion of the author that...' This means exactly the same as 'I think...' but has four times as many words. Lawyers tend to write 'It is submitted that...' which is even worse. Submitted by whom exactly? The worst affront to the English language of this type is the double passive: "It is regretted that futher data was unable to be collected." What the author meant was: "Unfortunately, we could not collect more data". Authors must make up their own minds about the good points and bad points of different styles, but should do so after careful consideration, rather than according to dogma.

The use of passive-voice expressions probably follows from authors' attempts to give the impression of impartiality. I don't think readers will be fooled into thinking that, if you sound impartial, you are impartial. But that's just my opinion.

In general, I think appropriate humour is fine in a technical report. But if your report is about, say, theorem proving methods, or detection of bowel cancers, what sort of humour is likely to be appropriate? Many attempted jokes detract badly from the message the author wants to convey. Nevertheless, occasionally it works.

On the whole you should probably not write the way you speak, for two reasons. First, you probably use colloquial and ungrammatical expressions in your speech that the reader will not understand (I'm sure I do). The reader cannot stop you and ask for an explanation. Second, in writing you don't have access to the differences in emphasis and tone of voice that help spoken communication. As you have to rely entirely on the words themselves, you need to choose them with care.

Have said that, I confess that I prefer to read reports well-written in colloquial speech idioms, than those badly written in an affected academic style.

5.3 Presentation

With apologies to Oscar Wilde, style isn't more important than substance -- not in science, at least. Good presentation is, I venture to suggest, less important than sound technical content. However, that doesn't mean that it is unimportant: the decision about how much time a potential reader is prepared to spend looking at your report will be based to a large extent on the first impression made by the presentation.

With modern computer software, it is relatively easy for anybody to prepare elegant documents and web pages. Even complex mathematics can be typeset stylishly using tools like LaTeX, using nothing more than a desktop computer. Software does not much help with consistency, however. A document is consistent if, for example, it always uses the same typeface for headings and for captions, if all lines have the same spacing, if all pictures are centred on the page, and so on. The simple solution to this problem is to print the document and have it looked at by an impartial, critical person. I would argue that this is the case for on-line reporting as well.

The final part of preparation of a printed report is usually binding. It doesn't cost very much to have a report spiral-bound, and it will be much easier to read than if it is stapled or ring-bound. Hot glue binding can be very effective (and cheap) for thin documents. Unless there are rules to the contrary, it is probably not worth the effort and expense of hard binding a report. I like to receive reports that are glue-bound in plastic covers so I can read them in the bathtub without getting wet fingerprints on the pages.

5.4 Inclusivity

Issues of inclusivity now affect all writers. It is all too easy, particularly in science and engineering, to write in a way that subtly excludes or diminishes particular groups. The days are long gone when we could write "he" and "him", and assume that the reader would understand that these terms included the other half of the human race as well.

The problem, however, is not solved simply by avoid overtly gender-laden terms. Particular modes of expression are so entrenched in some industries that we no longer really think about what we're saying. A female colleague recently suggested that a woman would not have started using terms like "terminate" or "abort" to mean "stop a computer program". It's plausible that this is true, and that the widespread use of such terms do subliminally "masculinize" the computing industry, particularly when they are ubiquitous.

Similarly, there is currently widespread pressure to avoid terms that seem tacitly to legitimize slavery and racism. We are advised even to avoid terms like "master", which has many meanings that are not remotely associated with slavery. Terms like "blacklist", meaning to exclude, are widely thought to have racist overtones; this is a term that I have used many times, without really noticing this possibility.

The problem that every writer has to tackle is that of finding balance. Of course we need to avoid overtly derogatory and discriminatory terms in professional writing, but it's increasingly hard to write in a way to which nobody at all can object. I've been criticised for using the term "bacon sandwich" in a training manual. Some religious groups do not eat bacon and, I was told, "normalizing" the eating of bacon can be seen as exclusionary. As a vegetarian, I don't eat bacon myself, but it doesn't offend me to see the term in print. Sadly, avoiding every possible way in which we might inadvertently give offence leads to very bland writing.

I've been writing professionally for decades, but I have to confess that I don't have a solution to this problem. All that writers can do, I think, is to try to read their work from the perspective of people of other races, religions, and genders. Better still, we should have our work read and commented on by such people. Of course, thorough reviewing by other people is always beneficial, not just for inclusivity but for readability and accuracy.

6 Graphic material

Few technical reports consist only of text; it is usual to include graphs, photographs, or charts. Here are a few hints on including such material; these should all be obvious, but sometimes people forget.

7 Things to avoid

Here, in no particular order, are some suggestions of things to avoid in a technical report. Please note that I am not saying they should be avoided in all types of writing; but a technical report has a particular function and audience, and the writing should reflect this. Naturally this section describes things that I particularly dislike; it does not necessarily follow that everyone else will feel the same.

8 General guidelines

Finally, here are a few general suggestions, in no particular order.

Bibliography

There are many good books on the subject of technical writing, but, in my opinion, none of these are written by or for scientists. The following books are the ones to which I referred when I started teaching.

Of these, O'Connor (1991) is probably the most accessible for beginners, but the style it advocates is a bit stuffy for my taste. I can't be sure that any of these books (apart from Fowler's) are still in print, but in any case you should look for a book that suits your own preference.