Rollout

The final delivery of the full project is to be scheduled in the Development Plan, but delivery MUST be between 9:00 AM on Mon May 10, and noon on Fri, May 14. NOTE: The drop-dead date for this project is noon, Fri, May 14. NO Project deliveries will be accepted after this time.

In addition to deliverable content (listed below), rollout will include a final delivery meeting with the CLIENTS. At this time, the group must demonstrate the full functionality of its project, provide a walk-through of usage, demonstrate example test code, etc.

Deliverable content for this project includes:

DCoreWars.jar
A jar archive file containing all class files necessary to run the DCoreWars program and provide all specified functionality.
Java source files
A subdirectory named src/ MUST be provided that includes the entire Java source code tree for all .class files in the DCoreWars.jar file, as well as any other support code (e.g., programs used in testing the code that are not part of the DCoreWars program itself). Note: if these programs depend on external library code other than the Java JDK or the gnu.getopt suite, the submission tarball MUST either include the library whole or provide easy and explicit instructions on how and where to access such libraries. This documentation MUST be provided in the README.TXT file. The designer is responsible for ensuring that all copyright and distribution conditions are adhered to.
README.TXT
This file MUST describe how to compile, configure, and install the DCoreWars program, including how to construct the .jar file from the raw source code. It MUST also list any dependencies on additional software support libraries. Furthermore, if the software suite provides more than one executable (e.g., if the assembler is separate from the main game client, or there are auxiliary testing programs provided), the README.TXT file should indicate what programs are included in the suite and how to run them. Complete documentation for such auxiliary programs MUST be included in the user documentation.
Internal documentation
The handin MUST also include the full, compiled JavaDoc documentation for all Java source files in the submission tarball. This documentation MUST include full descriptions of every public or protected method, field, sub-class, enclosed class, or constructor employed by the code. This documentation hierarchy MUST be included in a sub-directory named documentation/ within the submission tarball package.
User documentation
The handin submission MUST include complete user-level documentation for the DCoreWars program suite. This documentation MUST include descriptions of how to use the main game client program as well as any auxiliary programs (e.g., a separate assembler). It must describe the User Interface of the program, how to interpret output/buttons/dialogs/screens/etc., and at least one step-by-step example of running the program, playing a game, interpreting the results, etc. This document MUST be named USERDOC.extension, but it MAY be be a plain text, HTML, PDF, or PostScript document (with the appropriate extension). It MUST NOT be a Microsoft Word or other nonportable format document.
Design documentation
The final submission must also include one or more documents that describe both the initial design of the system (as proposed in Milestone 1), the final design and features of the system (as delivered in the Rollout), and a rationale justifying the modifications (if any). Note: Modifications to the original design are not bad. In fact, they are expected and encouraged. But the design documentation MUST describe why any such changes are made. E.g., refined understanding of the specification, design discussions with the CLIENTS, improved efficiency or modularity, improved use of Java language features, scaling back design to meet deadlines, untenable original design, improved support for requirements, etc. are typical reasons for modifying the design.
Test cases
The submission tarball MUST include a subdirectory named tests/ that includes all of the data or test cases used in unit, regression, or integration testing of the DCoreWars system.
CVS log file(s)
For each Java source file, the submission tarball MUST include a corresponding .log file including the CVS log for that sourcecode.
Team evaluations
Each team member must independently provide a written assessment of their own performance within the design team as well as the performance of the other team members. This is to be delivered by email directly to the CLIENTS and is not to be included in the group submission package. This information will be kept strictly confidential by the CLIENTS.

Terran Lane 2004-03-29