COMP 202: Principles of Object-Oriented Programming II← README Guidelines →
|Home — Fall 2008|||||Information|||||Resources|||||Exam Resources|||||OwlSpace|||||COMP 201|
When we grade your project, the first thing we will look for is the
README file in the root of the assignment
directory. The assignment directory is the root
directory of the directory tree that you zip up to hand in. NEVER
just leave a bunch of source code files there, and
leave your grader to guess what you supposed to do.
The README file should serve as a clear description of what you have done (and what you have not done if you don't finish some part), and aroadmap of what other files and directories inside your assignment directory are about.
You should also give a *high* level documentation of your work. (Don't expect your comment in source code can do that. It only serves as low level documentation of your code, but not overall understanding of your project.
This should include introduction of the problems you solve, your solutions, including algorithm, data structure(class, method, relations between classes). However, for this part, you should avoid simply listing together some code excerpts, and tell what each fields and methods are. Instead you should give general description so others can understand your work without digging into much details of lengthy code. Some
pseudo-code may be necessary, but use it sparingly.
We expect your README file to be a format of mini technical report, at least have the following sections:
Good documentation is integral component of good software development.
So start sharpen your skills of that from now!
Copyright © 2008-2010 Mathias Ricken and Stephen Wong