Monday, February 15, 2010

Submission guideline

For the Iteration#1 submission, I went through some hard times as I built, ran and executed your acceptance tests. Most submissions had some kind of documents explaining the situation, but it still took some time to get the project built and run. To make it conforming lets try one of the two following alternatives:
  1. Submit an Eclipse project. Ensure that, i) Run > Run As > Java Application runs your application and ii) Run > Run As > JUnit test runs all the tests in your application.
  2. Submit a project that has the following structure
  • Project Root
    • run - a command file (preferably unix shell or windows cmd) that loads your application.
    • test - a command file that runs all the tests.
    • All other folders, files as you may have
Also Important are:
  1. All other files, such as time spent, log files and diagrams should be sent using PDF/Word/Excel/Text/PNG/JPG only. Othewise, I might not have the software to open your submission.
  2. Submission should be emailed in a single email, instead of in parts. Otherwise, I may not see one of your submissions.
Large scale software development projects usually follow some standards for deploying their product frequently and frictionlessly. Thats why I mentioned using Eclipse or Maven could help you in conforming to shared standards. Lets see a few standards here:
  1. When built, your .class files should be separated from your .java files so that it is easy to deploy only the .class files. I know using some commands you can easily extract the class files from the source files, however, the target is to simplify the process as much as possible.
  2. Your acceptance and all test class files should be in a separate folder than your application class files. So that, when you deploy your application, you don't waste space in deploying the test classes.
  3. Most java applications are deployed as Jar files instead of a lot of class files. So, when you build one, its a good practice to make the final build output is archived to a jar file, which is easy to transport and manage.
Please comment here if I am missing something.

No comments:

Post a Comment