Homework Submission Requirements 810:062
|
This document outlines the rules you should follow when submitting a homework assignment for grading. These rules will simplify the grader's job by standardizing the form and appearance of submissions. Any of these rules can be overridden by a particular assignment but, if the assignment doesn't say otherwise, follow each of them.
When you are asked to submit a set of files, you must submit them in two forms: electronically and hard copy.
Your print-out should fit on standard 8-1/2"x11" paper printed upright, with no line wrap.
If you would like to save paper, you may print your files "2-up".
If you use PC-Grasp to print your files, turn off the "decorations" it uses to document program structure. I am glad these help you with your code, but they are distracting to the reader and take up valuable white space.
Yes, the order of the files matters.
Paper clips, folded corners, and nothing at all are not acceptable.
Electronic submissions will generally be due early on the morning of a class day. Unless told otherwise, you must submit your hardcopy at the beginning of our next class meeting.
Document each file with a header block that includes at least:
Here's an example:
// // FILE: Ball.java // AUTHOR: Eugene Wallingford -- wallingf@cns.uni.edu // DATE: 01/31/99 // COMMENT: Factored out of Budd's Ball class state and paint behavior. // // MODIFIED: 03/08/99 by Eugene Wallingford // CHANGE: Added a getColor() accessor. //
Your block need not look exactly like this, but it should contain the same information.
I do not require you to follow a lot of specific style rules, but I do ask you to follow several basic guidelines to improve the readability of your code.
for (int i = 0; i < 10; i++) System.out.println( i );
instead of this:
for (int i = 0; i < 10; i++) System.out.println( i );