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

Week 9 [Fri, Oct 7th] - Project

tP: v1.2

  1. Deliver v1.2
  2. Wrap up v1.2
  3. Do an informal demo of v1.2 before the tutorial

tP: v1.2

How to define version numbers?

While there is no universal set of rules on choosing version numbers for a product, there is a convention named SemVer that is well-defined and widely used. Our tP version numbers (v1.2, v1.3, v1.4 etc.) do not follow SemVer strictly though.

While on the topic of version numbers, milestones and versions are not the same thing. For example, you can have a version release in the middle of a milestone and you can define a milestone that does not release a new version of the product. For convenience, the tP uses them interchangeably (e.g., v1.2 is used to mean a version as well as a milestone) because its major milestones coincide with its version releases.

Using parallel PRs yet? We encourage you to try sending parallel PRs (i.e., send another PR while the previous PR you sent is waiting to be merged) if you haven't done that yet. Reason: It's important to learn how to do that, because in most real projects it is common to have multiple open PRs from the same author.

1 Deliver v1.2

  • The product must be working although the functionality is basic.

2 Wrap up v1.2

  • Manage the milestone v1.2 as explained in the panel below.

  • Wrap up the milestone using a git tag v1.2. When the milestone deadline is near (e.g., 0.5 days before the deadline), if you think some of the ongoing work intended for the current milestone may not finish in time, reassign them to a future milestone.
  • Do a release on GitHub. Uploading a JAR file to GitHub is optional.

3 Do an informal demo of v1.2 before the tutorial

  • As we don't have in-class tutorials this semester, do the following in lieu of a live demo:
    [one member] Run your app using the latest released version v1.2 (or v1.2b, if applicable). Take screenshots of each available feature in action. Add those screenshots to your collaborative project notes document with an appropriate heading e.g., v1.2 features demo. Alternatively, you can screen-record a demo, upload it to somewhere, and post the link in the project notes document.