About the project submission in May

From Info216
Jump to: navigation, search

Here is some more information about the final submission of your programming projects in May.

Submission

The end result of the project should be submitted electronically as a ZIP archive through Inspera (eksamen.uib.no). The archive should contain your complete Eclipse project, but do not include large semantic data sets like DBpedia. You do not need to include standard libraries like Jena either. Instead, include a file README.TXT in the root of the project directory to let us know what is needed before your code can be run, and how to run it, if it needs something special.

In addition to your code, the ZIP archive should contain a two-page description of your project (see below). You can also include small example data sets to run the code on, if you want.

The file name of your archive should contain the exam numbers of everyone in the group, for example INFO216ProjectSpring17_108_116.zip .

Code

You should comment the code lightly in-line. This does not mean one comment line for each code line but, e.g., one brief comment for each logical group of code lines. We do not require full Javadoc.

Project description

Your ZIP archive should contain a short project description. Put this description in the root folder of your Eclipse project before you ZIP it. The project description file should be anonymous, and contain the exam numbers of all group members, BOTH on the first page and in the file name (e.g., INFO216ProjectDescription_108_116.pdf .)

The length of the project description is max 2 A4 pages with 11pt font and 2.5 cm margins. This is a HARD limit. You can have appendices, though, and any figures or tables come in addition to the two pages. The quality of your code and idea is more important than the quality of the 2-page description.

You should briefly explain the purpose of your system. Why have you made this? Why is it a good idea to do this using semantic technologies? What can you do now that wasn't possible before?

You should probably list the technologies/tools/standards/vocabularies you have used and explain briefly why you chose each of them. Did you consider alternatives? Why were the ones you chose better?

If you are reading/converting/lifting data from multiple sources and/or using existing tools in addition to your own program, you should probably include a flow chart or architecture sketch (which is different from a class diagram).

You should probably include a class diagram of your system.

You should mention any particular problems you have had and/or things you want to do differently next time. You should describe the contributions each person in your group has made to the project.

If you want to briefly describe how to run the code you have submitted, you can do that separately in a README.TXT file.

INFO216, UiB, Spring 2017, Prof. Andreas L. Opdahl (c)