Professional Documents
Culture Documents
Annex D - Writing and Presentation Guide
Annex D - Writing and Presentation Guide
Introduction
This guidance describes the conventions and standards that we expect in the
production of written reports and summaries of research commissioned by HM
Revenue & Customs, whether intended for internal use and/or for publication.
The aim of this guide is to help authors produce reports which reflect the needs of
HM Revenue & Customs for clearly and concisely presented reports which will be
understood by their intended audience.
It is hoped that using these guidelines will help to: streamline the reporting process;
reduce the need for extensive comment and redrafting; and maximise the impact of
the final report.
These guidelines are the basis for good practice and may not cover all eventualities.
Discussion between the project manager and the contractor will be expected on all
work, to ensure the quality of the final report.
1 - General Guidelines
2 - Content, Methodology and Analysis
3 - Presentation, Structure and Writing Style
4 - Processes
Protective Marking: PROTECT. Do not copy, cite or circulate this document without
prior permission from HMRC.
1. GENERAL GUIDELINES
1.1 Two basic principles to be observed are that:
1.3 Layout
Protective Marking: PROTECT. Do not copy, cite or circulate this document without
prior permission from HMRC.
2. Content, Methodology and Analysis
The report should clearly and fully reflect the agreed aims of the research, should be
impartial and clearly indicate when the research took place.
• Findings and conclusions must be substantiated by the evidence: the report
should not offer unsubstantiated opinion as research evidence or, for instance,
imply causality where none is proven
• Any recommendations, where requested, should clearly stem from the
interpretation of the evidence, where possible being linked back to specific key
findings.
• The report should contain an executive summary highlighting the key findings
• The report should contain an introductory section setting out aims and objectives
of the project and the context of the research and a brief account of the
methodology
• Each section reporting findings should contain a summary box to highlight key
points
• The report structure should be agreed with the Project Manager well in advance
of the draft report and should be appropriate to the audience (in most cases this
is likely to be policy makers and analysts or practitioners)
• The report should normally be structured around the findings - addressed in a
thematic, rather than a chronological or serial way - and not around the
methodology (which should be addressed in detail in an Annex).
For Quantitative work, for instance whether the finding was applicable to the whole
sample, related to a single case study, a majority view etc.
• Where possible findings should be quantified and, where appropriate, statistical
significance referred to
• Where percentages are quoted, it should be clear exactly what they are
describing
• Where precise figures are not available or are inappropriate use the greatest
degree of precision possible - for instance "most" may be preferable to "many", or
rough approximations such as "around three quarters" better still
• Details of the size and make up of the sample should be given.
For Qualitative work, for instance how the sample was selected, whether a wide
range of views were sought or detail on specific issues, whether the qualitative work
is getting detail beneath quantitative findings etc.
• It should be clear which populations are the subject of research
• It should be clear that findings are not generalisable to a whole population
• Reporting should make clear the extent to which findings reflect a narrow range
of individuals or reflect various types of individuals and a breadth of views.
Protective Marking: PROTECT. Do not copy, cite or circulate this document without
prior permission from HMRC.
2.4 Presenting methodology and research tools
2.5 Generalisations
Any review of previous literature should clearly relate to the aims and objectives of
the report. It should also indicate the status of the literature reviewed, whether it has
been subject to any rigorous quality control criteria and how robust any cited findings
are.
2.7 Anonymity
• Use charts and diagrams, where appropriate, to illustrate the findings and to
break up the text
• Tables and figures should be headed, numbered, sourced and clearly and
accurately referenced in the text
• Any changes made to tables during editing should be reflected in the appropriate
sections of the text
• Where a report contains many such figures, a comprehensive list should be
provided in the table of contents
• Tables of data should normally be presented with row and column totals and
base totals
Protective Marking: PROTECT. Do not copy, cite or circulate this document without
prior permission from HMRC.
• A definition should be given of the base sample, e.g. all respondents (n) or all
respondents using PAYE (n)
• It should be clear whether percentages are weighted or unweighted (in most
cases these will be weighted)
• Always give unweighted bases in the table where the difference between
weighted and unweighted numbers is small, but where the weights are large,
and the two sets of numbers are very different, both bases should be included
and an explanation of this given
• Any weighting used should be explained to the reader, in a way which is
understandable to a non-specialist audience
• Tables should have supporting text
• If a table is too big to be contained on one page, it will need to be simplified or
split into more than one table
• Where a series of charts presents information on the same variables (e.g. levels
of take up of services for different groups), it is helpful to have consistent scaling
throughout to aid comparison
• Chart axes should be clearly and unambiguously labelled
• Where a series of charts presents information on the same variables, the same
naming conventions should be used throughout
• For charts illustrating more than one variable, a legend should be included
• All analysis should be checked by more than one person to check for reliability.
• If there have been previously disseminated or published interim reports, the final
report should show clear links between the emerging findings in the interim report
and the findings in the final report
• For unpublished interim reports, it will normally be the case that a clear
development from the interim to the final report is evident, with the final report
including and building upon any important findings from the interim report
• Any other work, including earlier or interim reports, mentioned in the text should
be fully referenced.
Protective Marking: PROTECT. Do not copy, cite or circulate this document without
prior permission from HMRC.
3. Presentation, Structure and Writing Style
3.1 Draft Reports
All drafts will be as close as possible to the final version of the report and will
comply with all the standards set out in this document.
• The draft report will be proof read and quality assured by the contractor and be
ready for dissemination and/or publication subject to amendments by the
Department
• It is usually preferable for proof reading to be done by someone other than the
main author
• The draft report will not be a ‘work in progress’
• The date and status of the report should be clear (e.g. First Draft, June 2003).
Contents
3.3 Order of Contents
This will include the title of the report, names of authors, research organisation, date
and status.
3.5 Disclaimer
Protective Marking: PROTECT. Do not copy, cite or circulate this document without
prior permission from HMRC.
3.6 Lists of Contents, Tables and Charts
• The list of contents will be separate from other pages and will be a full table of
contents, ie acknowledgements, summary, chapter headings, sub headings,
appendices, annexes, bibliography and references and index
• Tables and charts will be listed separately on the page following the contents
page
• Contents and lists of tables and charts will be set up in tables format
3.7 Acknowledgements
The author(s) may provide a statement at the beginning of the report acknowledging
the assistance of others, including co-workers, which should not be included in the
main body of the report.
3.8 Glossary
There will be a glossary of abbreviations, acronyms, terms and definitions used in the
report.
As outlined above, and in line with the Inland Revenue template for summaries.
The text of the report will conform to all of the guidelines laid out in this guide.
3.13 Index
Where this is to be included, the index will be a maximum of two pages listing the
topics that the report authors think will be most useful to the reader, showing the
page and/or paragraph numbers where the topics occur.
Protective Marking: PROTECT. Do not copy, cite or circulate this document without
prior permission from HMRC.
Presentation Style
3.14 Typeface of the Report
Use 1.5 or double line spacing for draft reports, and single line spacing for final
reports
3.17 Logo
If logos are included they must conform to guidelines, and will be provided by the
project manager.
3.18 Format
3.19 Headers
• Give the title of the report in a page header on the left-hand page and the name
of the chapter in a header on the right-hand page
• Underline the headers for the whole width of the page.
Each section reporting findings should contain a summary box to highlight key points
at the start of the section.
3.21 Headings
• Will be in bold with initial capitals and in the same font as the text
• Headings will not be in capitals
• Chapter headings will be 20pt, sub-headings 14pt and smaller headings 11pt
• Line spacing will be 2 spaces above a heading and 1 space below
• There should not be more than four levels of headings.
Protective Marking: PROTECT. Do not copy, cite or circulate this document without
prior permission from HMRC.
3.23 Length
The report should aim for brevity and clarity. The length of a report will obviously
vary depending on the scale of the research and on the intended audience.
Researchers should liase with the Research Manager to establish the expected
length of the report.
Give each chapter a number and use that number in paragraph numbering, for
example:
1.1
1.2
2.1
2.2
2.3 and so on.
• Sentences are easier to understand if they are short, generally with fewer than
twenty five words
• Sentences should be active rather than passive, for example ‘The customer
should be asked to complete the form’ is passive whereas ‘Ask the customer to
complete the form’ is active.
• Paragraphs should represent a single topic or set of ideas and be about four or
five sentence long
• Present information in a list if possible
• Avoid long, unbroken, dense sections of text.
• Insert tables and charts within the text where they will be most convenient for the
reader
• Refer to tables and figures as Table 1.1, Figure 2.1, etc, rather than as ‘above’,
‘below’ or ‘overleaf’, since pagination may change
• As a general rule, make them the same width as the main text
• Number them consecutively within chapters and type the title above the table
• Within tables, use a minimum number of horizontal lines and vertical lines
• Do not put lines or boxes round tables or charts
• Use Arabic numerals, ie 1, 2, 3 etc.
• Acknowledge the source of tables containing data which do not originate from the
research being reported.
3.27 Footnotes
• Avoid footnotes where possible. If they are necessary, insert them at the bottom
of the relevant page in the same font as the text but reduced to 10pt.
Protective Marking: PROTECT. Do not copy, cite or circulate this document without
prior permission from HMRC.
3.29 Dates
The format to use is 20 March 2005. Do not use 3rd, 4th and so on.
• In text, spell out numbers from one to ten and use Arabic numerals for 11 and
above
• Try to avoid sentences starting with numerals. If it is necessary, the number
should be written in full, eg, Seventy-three employers were interviewed.’
• When referring to pages or paragraphs use Arabic numerals for all numbers
• In tables use Arabic numerals for all numbers
• Use “per cent” rather than “%” in text
• There should be a comma between each set of three numerals counting from the
right, ie: 3,000; 3,000,000. 360,000 is preferred to 0.36 million. The decimal
point should be shown as a full stop, not a comma
• Fractions should be written out in the text and hyphenated, eg one-third, two-
fifths, and in tables and diagrams they should be presented in numerical form.
Use the singular verb for all group nouns, for example HM Revenue & Customs has
introduced ... not HM Revenue & Customs have introduced...
3.34 Lists
Use colon and semi-colons if running on in a sentence, ie: Enquiry Centres; Areas;
Regions, or use bullet points to introduce each item with a full stop at the end of the
last line:
• Enquiry Centres
• Areas
• Regions.
• When listing up to four separate points use first, second, third, finally. If any more
items are to be listed, use bullet points.
3.35 Gender
Protective Marking: PROTECT. Do not copy, cite or circulate this document without
prior permission from HMRC.
use the plural:
3.36 Cross-references
• Unless in common English usage, put the name in full when first used followed by
the abbreviation or acronym in brackets, and then use the abbreviation for
example: ‘The main subject of this chapter is Corporation Tax (CT). The aspects
of CT covered are …’ This is in addition to including key ones in the glossary
• Do not use full stops within abbreviations or acronyms
• References to HM Revenue & Customs should not be abbreviated.
Use initial capitals only for proper nouns, trade names, and the like, in headings, and
when referring to figures and tables in the text.
Protective Marking: PROTECT. Do not copy, cite or circulate this document without
prior permission from HMRC.
4. Processes
• Your report should be on a disk or CD in Microsoft Word 2000 or above, and all
files should be Word document files
• You will also supply the number of paper copies requested by the project
manager. We require 3.5 inch high-density (1.44Mb) disks in MS-DOS format, or
a CD (zipped if necessary)
• You may only submit draft and final reports by email if agreed in writing with the
Project Manger
• Whether a report is submitted on disk, CD, or by email (if agreed), it should be
password protected. The password should not be sent by email, but
communicated by telephone once the receipt of the report has been
acknowledged by the project manager
• Save everything that is part of the draft or final report on the disk or CD with
separate files containing:
• research summary
• research report with summary, text, appendices and annexes
• This copy of your report will contain all formatting, for example bold, underline,
page numbers
• Do not include files that are not part of your report, for example datasets and
other material related to the project but not part of the report.
If you have any queries about this guide, please contact the project manager.
Protective Marking: PROTECT. Do not copy, cite or circulate this document without
prior permission from HMRC.