Homework Submission Requirements CS 3530 Design and Analysis of Algorithms Spring Semester 2014

Introduction

This document outlines the rules you should follow when you submit a programming 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.

Forms of Submission

When you are asked to submit a set of files, you must submit them in two forms: electronically and hard copy.

• electronically:
  • Log in to the CS 3530 section of the department's electronic submission system using your UNI username and password.
  
  
  • Select the desired assignment.
  
  
  • Follow the instructions given to upload the required files and, if allowed for that assignment, any optional files.


• hard copy:
  • Print a hard copy of the files specified in the assignment.

    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".

  
  
  • Assemble them in the order specified by the assignment.

    Yes, the order of the files matters.

  
  
  • Staple them.

    Paper clips, folded corners, and nothing at all are not acceptable.

  
  
  • Bring the hardcopy to your next class period.

    Electronic submissions will generally be due early on the morning of a class day. Unless told otherwise, you must submit your hardcopy by the beginning of our next class meeting. You may always deliver your print-out to the department office prior to class time.

Documentation

Document each source file with a header block that includes the file's name, your name, the name of the file's original creator (if not you), and a modification history that lists the date of each change to the file and the change made.

Here's an example for a Racket file:

    ;;
    ;; FILE:     factorial-aps.rkt
    ;; AUTHOR:   Eugene Wallingford
    ;; DATE:     2013/01/31
    ;; COMMENT:  Uses accumulator passing style.
    ;;
    ;; MODIFIED: 2013/03/08 by Eugene Wallingford
    ;; CHANGE:   Fixed base case to handle negative arguments
    ;;

Your block need not look exactly like this, but it should contain the same information.

Style

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.

1. Indent your code to indicate that one expression is contained within another. This is essential regardless of the language you use.


2. Indent consistently. If you choose not to use a community standard for your chosen language, adopt a standard of your own and use it consistently throughout your code. Indent all sub-expressions the same number of characters. Indent all statement bodies the same number of characters. Be consistent within a single file and across multiple files. Adopt some conventions that you like, and stick with them.


3. Use names that say what they name. For example, num-scores is a better name than n, and number-of-scores is better yet. By convention, we generally use single-letter variable names only as names of generic numbers and as the index variables on loops.

If you have any questions about style, pleas ask.