How to interpret your Project #1 Grade Sheet

ID: Your userid

Total: The total number of points out of a possible 16

Usability: This should actually be the section for Code Quality. The four numbers correspond to (2 points each):

Comments (esp. for unclear code)

Clarity (variable names, code structure, flow of control, small # of files)

Modularity (using functions, and not reinventing PHP functions)

Error handling (don't simply "die" upon an error)

The comment codes which are given in capital letters can be interpreted as follows:

A - Insufficient comments

B - Repetition of chunks of code

C - Actual bugs, broken functionality

D - Excessive AND unnecessary # of files

E - Errors are simply by dying with very minimal error message, or are not handled at all

F - Difficult to understand flow of program

G - No attempt to decompose with functions

H - No attempt to separate #define-ish variables into separate section

I - Absent or insufficient README file

J - Cryptic or unnecessarily complicated variable names

K - Replication of PHP functionality with own functions

L - Better to put comments in PHP code rather than use HTML comments

Code Quality: This should actually be the section for Usability. The four numbers correspond to:

Readable and appealing text/graphics (3 points)

Handles test input (HTML, quotes, spaces, etc.) (1 point)

Reasonable UI (instructions, form structure, error messages, info density, etc.) (2 points)

Navigational ease of use (1 point)

The comment codes which are given in capital letters can be interpreted as follows:

A - strange or misproportioned layout, poorly placed text

B - visual harshness, distracting or clashing color choices

C - unclear, difficult to find, or missing error messages or feedback

D - lack of originality, clear copy of example UI

E - insufficient or unclear instructions

F - insufficient input validation

G - "buggy" or strange behavior (broken links, random text, etc.)

H - hitting enter key to query does not work

I - too much scrolling required

J - results not sorted

K - input truncated or dropped without warning

L - one or more overly restrictive input fields

M - gave us a wrong or broken URL

N - labels for fields too verbose

O - especially good looking

P - bad permissions; could not access via server

ID:	Your userid
Total:	The total number of points out of a possible 16
Usability:	This should actually be the section for Code Quality. The four numbers correspond to (2 points each): Comments (esp. for unclear code) Clarity (variable names, code structure, flow of control, small # of files) Modularity (using functions, and not reinventing PHP functions) Error handling (don't simply "die" upon an error) The comment codes which are given in capital letters can be interpreted as follows: A - Insufficient comments B - Repetition of chunks of code C - Actual bugs, broken functionality D - Excessive AND unnecessary # of files E - Errors are simply by dying with very minimal error message, or are not handled at all F - Difficult to understand flow of program G - No attempt to decompose with functions H - No attempt to separate #define-ish variables into separate section I - Absent or insufficient README file J - Cryptic or unnecessarily complicated variable names K - Replication of PHP functionality with own functions L - Better to put comments in PHP code rather than use HTML comments
Code Quality:	This should actually be the section for Usability. The four numbers correspond to: Readable and appealing text/graphics (3 points) Handles test input (HTML, quotes, spaces, etc.) (1 point) Reasonable UI (instructions, form structure, error messages, info density, etc.) (2 points) Navigational ease of use (1 point) The comment codes which are given in capital letters can be interpreted as follows: A - strange or misproportioned layout, poorly placed text B - visual harshness, distracting or clashing color choices C - unclear, difficult to find, or missing error messages or feedback D - lack of originality, clear copy of example UI E - insufficient or unclear instructions F - insufficient input validation G - "buggy" or strange behavior (broken links, random text, etc.) H - hitting enter key to query does not work I - too much scrolling required J - results not sorted K - input truncated or dropped without warning L - one or more overly restrictive input fields M - gave us a wrong or broken URL N - labels for fields too verbose O - especially good looking P - bad permissions; could not access via server