CIS Logo

University of Oregon
Computer & Information Science

CIS 422
Project 1 Grading
Winter 1999

Here are the grading standards I used for project 2 in Spring 1998. I will make minor adjustments to these to form the grading standards for Project 1 of Winter 1999.

 

Points

40 - Functionality

Robustness: 15

* 15 = absolutely bulletproof
* 12 = robust under reasonable use
* 8 = minor bugs, works well enough to be usable
* 4 = major bugs interfere with normal use

Feature Set: 10

* 10 = WOW! Exceptional
* 7 = All needed features and some pleasant surprises
* 5 = Adequate for the intended purpose
* 2 = Missing features interfere with normal use

Ease of setup: 5

* 5 = a snap to install - on a par with highly automated installers
* 3 = easy to install
* 2 = a little cumbersome, but installed without major problems
* 1 = major difficulties installing
* 0 = couldn't install

Ease of use: 15

* 15 = couldn't ask for more
* 12 = Quite usable, but could still be improved
* 8 = Adequate usability, won't discourage normal use
* 4 = Usability problems interfere with normal use
* 0 = Completely unusable

30 - External/User Documentation

README (README.txt or equivalent OBVIOUS orientation document): 7 pts

7 = complete overview with overview description and complete
manifest including guide to other documents
5 = very good README
3 = adequate README, but either
* some inappropriate choices of what to put in or leave out
* minor organizational problems that make it less useful than it would otherwise be
2 = README exists, but has flaws that limit its usefulness
0 = README doesn't exist or is useless

Installation/setup docs (complete? easy to follow?): 5 pts

5 = Excellent docs for both common and uncommon cases
3 = Adequate installation documentation, but could be improved
(e.g., for less common cases)
1 = Major flaws or omissions in installation documentation
0 = Missing or completely misleading installation documentation

User docs - tutorial/reference: 18 points

18 = really professional standards, on a par with the best commercial software
15 = Good solid documentation for both tutorial and reference use; not quite
professional standards, but very good for a short project
9 = adequate user documents for both tutorial and reference use
6 = not very useful, due to flaws, omissions, or poor organization
3 = barely useful at all
0 = no user documentation, or useless documentation

20 - Internal/Technical Documentation: pts total Color

Architecture/design overview document - 5 pts

5 = Excellent overview with
  • clear breakdown of system into major parts
  • clear description of criteria for breaking into subsystems (e.g., it would be obvious where code for a new feature should go)
  • abstract understanding of program behavior
3 = Adequate overview, good first step indicating where to look for
0 = No overview, or useless overview

Technical documentation as a whole - 15 pts
(may include external and internal documentation, Javadoc, etc.)

15 = Exceptionally complete and useful design documentation; with a small amount of study I could easily port, extend, or modify the system