This handout gives the suggested contents of report, and the suggested style for your term project.
(Note that the purpose of this guideline is not to discourage you, but to show what the database
documentation should look like.)
1. Basic Principle of Documentation
The basic principle of documentation in any report is very simple: readers should be able to
understand your work and grade your project by just reading your report without you. For this purpose
I suggest you keep in mind the following four points.
1) Readers of your report should be able to tell what you have accomplished. For example, you can
include the following ideas if they are relevant to your problems: what problems you have worked
on, what assumptions you have made in your work, how much you have accomplished, what parts
you did not finish (or limitation of the result of your work: do not try to hide the problems;
nobody's work is perfect), how well you did, how important your work is, why it is important,
where it can be applied, what kinds of difficult problems you had during your work, what the
remaining problems are, what parts can be done as next steps, etc.
2) The report should be easily readable and understandable. No matter how significant your work
may be, it is not worth full credit, if you cannot convince readers. Use clear and concise English.
Keep in mind you should write to communicate with readers, not document for yourself.
3) The report should be well organized. It should have a clear logical sequence. Organize your work
in chapters, sections, and sub-sections with meaningful headings. Include diagrams, tables, or
figures whenever appropriate.
4) The report should be self-contained, if possible. Do not ask readers to look around other
references, unless you have a reason to do so.
2. Contents of Report
2.1. Application Development
1) A summary of the problem and an overview of your work.
2) Detailed problem Description
a) Problem Descriptions
b) Assumptions
c) The way you obtained your information
d) Your methodology to solve the problem
e) Environments (e.g., hardware, software, equipment, policy of the company, etc.)
f) Any special considerations specific to your problem
3) Conceptual design
a) Required operations or frequently expected queries, reports, etc.
b) ER diagram and its explanation (Explain entities, relationships, cardinalities, and attributes)
c) Relational schema
d) Data Dictionaries
e) FDs and Normalization
f) Routine queries and report types
4) Implementation
a) Organization of the overall program
b) Brief explanation of each module
c) Specify previous work and your work
d) Indexing schemes
e) How to run the program
1
College of Computing and Informatics Drexel University
f) Problems you encountered during your work
g) Limitation of the work
h) Future work
5) Conclusion
a) Summary of your work including limitations
b) Lessons learned
6) References
7) Appendix
a) Sample input
b) Program listing
c) Sample output
d) Graphical User Interface (GUI) Layout and its screen shots
e) User Documentation
i) Installation instructions
ii) README: explaining how to interact with your system
f) All source programs that are developed for your system
g) Division of work (i.e., each member’s contribution)