CS4490z Reports
Format and Style Guidelines
Format
- Each report should have a Title Page containing the
following information:
- title
of project
- whether
it is a software project or a research project
- your
name and email address
- name
of your supervisor(s)
- signature
of the supervisor(s), indicating approval of the report
- Use headings for each section of the report.
- Include references where appropriate.
(Discuss the format for citing references with your supervisor. There are
many acceptable formats.)
- Consider using footnotes for factual references (but
do not over-footnote).
- It is often helpful to include a glossary of terms
and a list of abbreviations and acronyms.
- Incorporate figures and tables in the appropriate
point within the text of the document. Figures and tables should be referred
to within the text. If a figure is taken from an external source, give a
reference.
- Print single-sided on 8.5 by 11 inch paper.
- Number the pages.
- Do not use a font size smaller than 12 points for
the general text (although you may do so for footnotes, code, appendices,
etc.).
- For the general text, use 1.5 spacing
between lines (although you may use single spacing for references and
indented long quotations).
Style
- Use a spell checker.
- Check grammar, punctuation, apostrophes (e.g. it's
is the abbreviation for it
is, not a possessive pronoun!)
- The reports are formal documents, so avoid using abbreviations (other than
i.e., e.g., and etc.)
and abbreviations such as isn't for is
not.
- Do not use jargon or slang expressions.
References
There are several books in the library that might help
with your written reports:
- Zobel, "Writing for Computer
Science"
- Dawson, "Projects in Computing and Information
Systems: A Student's Guide"