The target audience for the class project documentation is the team itself and the course personnel grading the project.
Each project needs to contain under version control a directory
Documentation containing an up to date documentation of the project.
As a whole the documentation graded should contain:
a PDF-document under the directory
the log information in the versioncontrol repository
code comments including possible interface documentation of own classes
The two latter are in version control as is and are not separately included into the PDF-document.
The PDF-document decribes:
the structure of the part of the software implemented by the course team. A clear hand drawn diagram is perfectly fine.
reponsibilities of the key classes
project functionality, including each extra feature clearly described
those classes implemented by the team containing pre and post conditions.
the agreed and actual division of work
a short user manual
known bugs or missing features
The document can be written what ever the team chooses but it must be turned in as a PDF file. The PDF-document should not exceed five (5) pages.