------- Start of forwarded message -------
Date: Mon, 16 Feb 2004 22:04:08 -0500 (EST)
From: Donna Gabai <dgabai@CS.Princeton.EDU>
To: tbroderi@Princeton.edu
cc: Randolph Wang <rywang@CS.Princeton.EDU>
Subject: Re: tbroderi@Princeton.EDU: COS 126 readme.txt
In-Reply-To: <200402170210.i1H2AeNH014768@willy.CS.Princeton.EDU>
X-Spam-Checker-Version: SpamAssassin 2.63 (2004-01-11) on 
	memphis.CS.Princeton.EDU
X-Spam-Status: No, hits=-99.6 required=5.0 tests=AWL,USER_IN_WHITELIST 
	autolearn=no version=2.63
X-Spam-Level: 

>  ------- Start of forwarded message ------- 
>  From: Tamara A Broderick <tbroderi@Princeton.EDU> 
>  To: rywang@Princeton.EDU 
>  Date: Mon, 16 Feb 2004 18:57:10 -0500 
>  Content-Language: en 
>  Subject: COS 126 readme.txt 
>  
>  In this program's readme.txt template, it asks us to write a "high 
>  level" description of each program. What does that entail? Is it enough 
>  to follow the format of the headers in the programs on the Intro to CS 
>  booksite? 
>  
>  Thanks, 
>  Tamara Broderick 
>  ------- End of forwarded message ------- 
>  
You don't need ALL that info (how to compile and run the program and a
sample run doesn't go here).  Just a brief summary of what each section
of the program does (in your own words, don't just copy the assignment
description) and how you did it.
e.g., for the Average.java program from Assignment 0 you might have:
********************************************
Read in an integer N from the command line.
Generate, print and sum N pseudo random numbers via a for loop, since
we know how many we want.
Compute and print the average.
*********************************************

The point of making you do this is two fold:
1) Before we even look at your code, we know whether you understood and
followed the directions.  You'd be surprised how many students miss a
whole section of the instructions - like not printing out all the numbers,
or trying to read from standard input instead of the command line in the
example above.

2) The how part gives us some idea of your understanding of the
programming techniques introduced that week.

regards,
 - Donna Gabai
------- End of forwarded message -------