This site is from a past semester! The current version will be here when the new semester starts.

Week 7 [Fri, Sep 17th] - Project

iP:

Set up a product website
Submit the final version Mon, Sep 27th 2359

tP:

Set up the project repo during the lecture
Practice the workflow with a sample repo
Plan the next iteration

iP

1 Set up a product website

Add a brief User Guide (UG)

Duke A-UserGuide: User Guide

2 Submit the final version Mon, Sep 27th 2359

Create a new jar file
- Create the JAR file in one of these ways:
  - If you have added a GUI or using third-party libraries: use Gradle.
  - Else: you can use Intellij.
- The JAR file should be cross-platform and should work in a computer that has Java 11.
Do the following smoke tests to ensure the jar file works (reason: a similar flow will be used when grading your iP).
1. Copy the jar file to an empty folder and test it from there. This should surface issues with hard-coded file paths.
2. Pass the jar file to team members and ask them to do a test drive. Assuming some of your team members' OS differ from yours, this should verify if the app is cross-platform.
Create a new release on GitHub (e.g., v0.2) and upload the JAR file.
- Recommended to refrain from uploading multiple JAR files as this can cause extra work for the evaluators.

Duke A-Release: Release

tP: Get ready for iterations

1 Set up the project repo during the lecture

Set up the team org, the team repo, and individual forks as explained below:

2 Practice the workflow with a sample repo

We recommend that you practice the forking workflow with your team members as described in the textbook section given in the panel below.
You can use your tP GitHub org for this exercise too.

3 Plan the next iteration

Plan the next iteration. As you know, you should follow the breadth-first iterative process. Therefore, first you must decide what functionalities should be in the product if you had only two weeks to implement it. You have done that already when you chose user stories for v1.0, translated that to features, and even drafted the UG based on those features. You can tweak that plan further at this point if you wish, given that you now have some idea of how fast the team can work when using the prescribed workflow.
- Aim to produce a working MVP at the end of this iteration even if the functionalities are not polished (polishing can be done in a later iteration).
- [Recommended, Optional] Break the iteration into two increments i.e., aim to produce an even simpler but working version after one week.
- Avoid depth-first implementations: "I'll do the back-end part of feature X in this iteration" is not acceptable as that is not in the spirit of breadth-first iterative process. Remember, we are pretending this to be the last iteration; why would you implement the back-end part of a feature in the last iteration?
  It is OK to add simpler versions of bigger features, but not OK to add partial features that can't be used yet.
Divide the work among the team members i.e., the work required for the current iteration.
Reflect the above plan in the issue tracker by assigning the corresponding issues (create new issues if necessary) to yourself and to the corresponding milestone. For example, the user story pertaining to the increment show a place holder for photo, showing a generic default image should be assigned to Jake and to milestone v1.0
If you split the iteration into two smaller iterations of one-week each (recommended), name the first one v1.0 and the second one v1.0b so that the dashboard can track them accurately. The reason for naming the earlier milestone as v1.0 is so that even if you fail to finish the second one, you can still get credit for reaching v1.0 (which is the milestone tracked by grading scripts) -- think of the first iteration as minimal deliverables for v1.0 and the second one as containing do-if-there-is-time improvements.