Project Deliverables
Users Manual
- This is a standard manual instructing users how to use the system
- If any systems or subsystems need installation, the manual must have a section on "System Installation" that specifies the environment and installation procedures necessary to install the system. For example, given the client-server architecture of
many of your project systems, this entails specifying the required server hardware and software, ditto for a client machine, the files that must be uploaded to the server (include a disk
containing the files), and any installation procedures that must be followed. In other words, a client given this information should be able to install your system in another (presumably the
customer's) environment that has the specified equipment. (A graduate assistant, QA team, or your instructor will likely test your installation procedures by trying to install your system either
on another server or in a different folder on the development server.)
- Include screen shots for a Web interface
Technical Paper for Possible Publication
- Typical sections include:
- Introduction (some material can come from the course website project description)
- Briefly introduce and describe the current study (the major problem or issue being investigated)
- Literature review - describe similar work and cite the references
- Discuss relevance of this work in the context of previous related work
- Build a case for the usefulness of the current study
- Show how the current investigation will advance understanding and explain why this matters
- Methodology (e.g., condense material from the system design or user manual)
- Results - usefulness, etc. (document any results, describe utility of system, etc.)
- Conclusions, Implications, Recommendations for future work, and Summary (make projections)
- The paper must be double-column in IEEE format (see IEEE template)
and limited to 8 pages. The main IEEE requirements are:
- Type-style and Fonts. Times or Times Roman font.
- The Main Title should be centered in Times 14-point, boldface type. Initially capitalize nouns, pronouns, verbs, adjectives, and adverbs; do not capitalize articles, coordinate
conjunctions, or prepositions (unless the title begins with such a word). Leave two 12-point blank lines after the title.
- Author's Name(s) and Affiliation(s) are to be centered beneath the title and printed in Times 12-point, non-boldface type. This information is to be followed by two 12-point blank
lines.
- The Abstract is to be in fully-justified italicized text, below the author and affiliation information. Use the word "Abstract" as the title, in 12-point Times, boldface type,
initially capitalized. The abstract is to be in 10-point, single-spaced type, and limited to 150 words.
- Main Text. Type main text in 10-point Times, single-spaced. Do NOT use double-spacing.
- First Order Headings should be Times 12-point boldface, initially capitalized, flush left, with one blank line before, and one blank line after. Use a period (".") after the
heading number, not a colon.
- Second Order Headings should be Times 11-point boldface, initially capitalized, flush left, with one blank line before, and one after.
- References. Number and list the references alphabetically by the last name of the first author
(this differs from some IEEE publications that require references listed in the order cited).
Use 9-point Times, single-spaced, at the end of your paper. When citing references
in the text, enclose the citation number in square brackets, for example [1].
- Guidelines
- The number of pages is limited to 8, including appendices.
- Each figure and table must be numbered, described in a caption, centered in the column, and cited in the text.
Figure and table citings and captions can easily be checked by searching on "fig" or "table".
- Avoid the term "project" in the paper, instead use other terms -
for example, "The study (or work or effort) focused on ..."
- Minimize the use of the words "very", "most", and other flowery and exaggerating adjectives.
- All references must be alphabetized by the first author's last name and each reference must be cited in the text.
Alphabetize a URL either by the author or site name - for example, Google, http://www.google.com/
is alphabetized under G. A URL reference must include the date last accessed - for example,
Google, http://www.google.com/, accessed November 2008 (month and year are sufficient).
- Avoid putting URLs in the text: when citing an online document,
put the URL into a reference and cite it in the text by number in the usual manner.
- The abstract should summarize the paper, emphasizing the important aspects
(such as the results and conclusions),
and should be the last section reviewed and finalized after completing the paper.
- The paper should be clearly written and flow smoothly.
All team members should read the paper carefully to find and correct all errors of technical content
and of writing (organization, spelling, grammar, clarity, etc.).
- Instructor's editings of sections of the paper are done using the "Track Changes" tool in Microsoft Word
and the changes are easily accepted by clicking on "Accept All Changes in Document."
The editing is intended to fix a few things and to give you an indication of how to edit,
and should not to be interpreted as fixing everything in the paper.
Project Website and Directory
Each team will be provided with a directory on the Utopia CSIS server. Using Secure FTP each team will create a simple website to post the project information
and a list of the project's team members. It will also serve as the repository of all projects deliverables and other project information (programs, data, etc.). For a continuation project, we
usually continue to use the same directory used by the previous team, which you will need to update with your project information and move the material from the earlier project into a subdirectory
so it doesn't get lost. For a new project, you will need to create a website and associated information from scratch. FTP access information (Host, Username, Password) will be emailed to each team
separately. A free download from Core FTP is easy-to-use FTP software, but you must check the box for SSH/SFTP (see screenshot). Note that the project ID on the Projects page of the course website is a link to the project directory and associated website on the Utopia server. Although it must
be completed, this is not a major deliverable and your team should not spend excessive effort on it.