Resources for written reports and oral presentations

[Class home]

Crediting others

• Proper citations are a hallmark of any solidly written report, and are often useful in other forms of publications. Citing · Help & how-to (2017) refers to several style guides; pick a suitable style and use it consistently. Especially see its section "Why cite?".
• If your report or presentation uses an active format such as PDF or HTML, URLs in citations should be clickable.
• For citations, submit a working link to a freely-readable copy if available, and also submit a working link to a URL based on digital object identifiers (DOIs) if available.

Here is an example citation using Vancouver system format:

1. Cao L. Data science: a comprehensive overview. ACM Comput Surv. 2017;50(3):43. doi:10.1145/3076253.

Breaking this citation down:

• The citation's title hyperlinks to a freely-readable resource <https://www-staff.it.uts.edu.au/~lbcao/publication/dsa-cusr.draft.pdf>.
• "ACM Comput Surv" is a standard abbreviation for ACM Computing Surveys. See Web of Science Journal Title Abbreviations for a list of reasonably-standard journal-title abbreviations.
• "2017;50(3):43" contains the year, volume, issue, and article or page numbers.
• The DOI hyperlinks to <http://dx.doi.org/10.1145/3076253>. Unfortunately, freely-available resources are often preliminary or ephemeral or both; when available, a DOI can permanently nail down the final, stable version even if it's not freely readable. For more about DOIs, see How to share a link to an article with your students and collaborators (2016).

Written reports

• Simon Peyton Jones's How to write a great research paper (2016) contains a brief and pleasant section about how to write a good research paper.
• Derek Dreyer's How to write papers so people can read them (2016) gives more-constructive advice that provides an interesting contrast with Peyton Jones.
• Roy Levin and David D. Redell's An Evaluation of the Ninth SOSP Submissions –or– How (and How Not) to Write a Good Systems Paper (1983) points out common problems in technical papers, and gives suggestions for how to fix them.
• The UNC Writing Center's Scientific Reports (2014) describes how to write and organize a scientific research report.
• David A. McMurrey's Online Technical Writing (2013) contains many examples and much discussion of technical writing. For example, it has a chapter on recommendation and feasibility reports that contains several sample reports.
• George Gopen and Judith Swan's The Science of Scientific Writing (1990) briefly summarizes some of the science behind writing clear writing for scientific audiences.
• William Strunk, Jr.'s The Elements of Style (1918) is the classic style guide for American English writing. It excels at showing how to omit needless words.
• The USENIX Templates for Conference Papers provides LaTeX and DOC templates and style files for computer science research papers. The USENIX templates use a two-column format with 10-point font for most of the text, on an 8½"×11" page. LaTeX typically generates higher-quality output for technical papers. An example of the output format and an example student paper are available.
• The Cabrillo Tidepool Study's Scientific Report Rubric (1997) is the sort of thing we use when evaluating your report.

Oral presentations

• Simon Peyton Jones's How to give a great research talk (2016) almost makes it look easy and covers the essentials. He's brave enough to point you to a video of himself, giving the talk.
• Michael Ernst's Giving a technical presentation (giving a scientific talk) (2016) contains workable and up-to-date advice for giving computer science talks.
• Mark D. Hill's Oral Presentation Advice (1997) briefly describes how to give a good talk. It contains a summary of David Patterson's classic How to Give a Bad Talk (1983).
• Judith P. Rhodes et al.'s Scientifically Speaking: Tips for Preparing Scientific Talks and Using Visual Aids (2005) contains advice and observations on preparing and delivering a scientific talk. Its advice on poster presentations is also valuable, though you can skip it if you are not making a poster.
• The Science and Engineering Library (SEL) has a learning center with equipment with which you can rehearse your presentation. Reserve a time slot by visiting the circulation desk in Boelter 8270.
• Caroline McCullen's Student Presentation Rubric (1997) is the sort of thing we use when evaluating your presentation.